Collator::sort

collator_sort

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

Collator::sort -- collator_sort — Sort array using specified collator

Description

Object oriented style

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

Procedural style

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

This function sorts an array according to current locale rules.

Equivalent to standard PHP sort() .

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 sorting type is Collator::SORT_REGULAR.

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example #1 collator_sort() example

 <?php
$coll = collator_create( 'en_US' );
$arr  = array( 'at', 'às', 'as' );

var_export( $arr );
collator_sort( $coll, $arr );
var_export( $arr );
?>

The above example will output:

  array (   0 => 'at',   1 => 'às',   2 => 'as', )array (   0 => 'as',   1 => 'às',   2 => 'at', )