Collator
Collator::compare
Collator
PHP Manual

# Collator::asort

# collator_asort

(No version information available, might be only in CVS)

collator_asort — Sort array maintaining index association

### Description

Object oriented style

bool Collator::asort ( array `&$arr` [, integer `$sort_flag` ] )

Procedural style

bool collator_asort ( Collator `$coll` , array `&$arr` [, integer `$sort_flag` ] )

This function sorts an array such that array indices maintain their correlation with the array elements they are associated with. This is used mainly when sorting associative arrays where the actual element order is significant. Array elements will have sort order according to current locale rules.

Equivalent to standard PHP asort().

### Parameters

`coll`

  Collator object.

`arr`

  Array of strings to sort.

`sort_flag`

  Optional sorting type, one of the following:

  - `Collator::SORT_REGULAR` - compare items normally (don't change types)

  - `Collator::SORT_NUMERIC` - compare items numerically

  - `Collator::SORT_STRING` - compare items as strings

  Default $sort_flag value is `Collator::SORT_REGULAR`. It is also used if an invalid $sort_flag value has been specified.

### Return Values

Returns `TRUE` on success or `FALSE` on failure.

### Examples

Example#1 collator_asort()example

`<?php
$coll = collator_create( 'en_US' );
$arr = array(
'a' => '100',
'b' => '50',
'c' => '7'
);
collator_asort( $coll, $arr, Collator::SORT_NUMERIC );
var_export( $arr );
collator_asort( $coll, $arr, Collator::SORT_STRING );
var_export( $arr );
?>`

The above example will output:

    array (
      'c' => '7',
      'b' => '50',
      'a' => '100',
    )array (
      'a' => '100',
      'b' => '50',
      'c' => '7',
    )

### See Also

- Collator constants
- collator_sort()
- collator_sort_with_sort_keys()

Collator
Collator::compare
Collator
PHP Manual