Collator::asort
PHP function
Edit on GitHub ✎
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Sort array maintaining index association
Description
Oop
Collator::asort(array $array, int $flags = Collator::SORT_REGULAR): bool
Procedural
collator_asort(Collator $object, array $array, int $flags = Collator::SORT_REGULAR): bool
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
objectCollatorobject.arrayArray of strings to sort.
flagsOptional sorting type, one of the following:
Collator::SORT_REGULAR- compare items normally (don't change types)Collator::SORT_NUMERIC- compare items numericallyCollator::SORT_STRING- compare items as strings
Default
flagsvalue isCollator::SORT_REGULAR. It is also used if an invalidflagsvalue has been specified.
Return Values
Success
Examples
collator_asort() example
php
<?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:
output
array (
'c' => '7',
'b' => '50',
'a' => '100',
)array (
'a' => '100',
'b' => '50',
'c' => '7',
)