PHP: sort - Manual
Upcoming Critical PHP Security Release uasort » « sizeof Preface Function Reference Variable and Type Related Extensions Arrays Array Functions sort (PHP 4, PHP 5, PHP 7, PHP 8) sort — Sort an array in ascending order Description function sort ( array &$array , int $flags = SORT_REGULAR ): true Sorts array in place by values in ascending order. Note : If two members compare as equal, they retain their original order.
Prior to PHP 8.0.0, their relative order in the sorted array was undefined. Note : This function assigns new keys to the elements in array . It will remove any existing keys that may have been assigned, rather than just reordering the keys. Note : Resets array's internal pointer to the first element. Parameters array The input array. flags The optional second parameter flags may be used to modify the sorting behavior using these values: Sorting type flags: SORT_REGULAR - compare items normally; the details are described in the comparison operators section SORT_NUMERIC - compare items numerically SORT_STRING - compare items as strings SORT_LOCALE_STRING - compare items as strings, based on the current locale.
It uses the locale, which can be changed using setlocale() SORT_NATURAL - compare items as strings using "natural ordering" like natsort() SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively Return Values Always returns true . Changelog Version Description 8.2.0 The return type is true now; previously, it was bool . Examples Example #1 sort() example <?php $fruits = array( "lemon" , "orange" , "banana" , "apple" ); sort ( $fruits ); foreach ( $fruits as $key => $val ) { echo "fruits[" . $key .
"] = " . $val . "\n" ; } ?> The above example will output: fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange The fruits have been sorted in alphabetical order. Example #2 sort() example using case-insensitive natural ordering <?php $fruits = array( "Orange1" , "orange2" , "Orange3" , "orange20" ); sort ( $fruits , SORT_NATURAL | SORT_FLAG_CASE ); foreach ( $fruits as $key => $val ) { echo "fruits[" . $key .
"] = " . $val . "\n" ; } ?> The above example will output: fruits[0] = Orange1 fruits[1] = orange2 fruits[2] = Orange3 fruits[3] = orange20 The fruits have been sorted like natcasesort() . Notes Note : Like most PHP sorting functions, sort() uses an implementation of » Quicksort . The pivot is chosen in the middle of the partition resulting in an optimal time for already sorted arrays. This is however an implementation detail you shouldn't rely on.
Warning Be careful when sorting arrays with mixed types values because sort() can produce unexpected results, if flags is SORT_REGULAR . See Also rsort() - Sort an array in descending order The comparison of array sorting functions Found A Problem? Learn How To Improve This Page • Submit a Pull Request • Report a Bug + add a note User Contributed Notes 35 notes up down 232 phpdotnet at m4tt dot co dot uk ¶ 16 years ago Simple function to sort an array by a specific key.
Maintains index association. <?php function array_sort ( $array , $on , $order = SORT_ASC ) { $new_array = array(); $sortable_array = array(); if ( count ( $array ) > 0 ) { foreach ( $array as $k => $v ) { if ( is_array ( $v )) { foreach ( $v as $k2 => $v2 ) { if ( $k2 == $on ) { $sortable_array [ $k ] = $v2 ; } } } else { $sortable_array [ $k ] = $v ; } } switch ( $order ) { case SORT_ASC : asort ( $sortable_array ); break; case SORT_DESC : arsort ( $sortable_array ); break; } foreach ( $sortable_array as $k => $v ) { $new_array [ $k ] = $array [ $k ]; } } return $new_array ; } $people = array( 12345 => array( 'id' => 12345 , 'first_name' => 'Joe' , 'surname' => 'Bloggs' , 'age' => 23 , 'sex' => 'm' ), 12346 => array( 'id' => 12346 , 'first_name' => 'Adam' , 'surname' => 'Smith' , 'age' => 18 , 'sex' => 'm' ), 12347 => array( 'id' => 12347 , 'first_name' => 'Amy' , 'surname' => 'Jones' , 'age' => 21 , 'sex' => 'f' ) ); print_r ( array_sort ( $people , 'age' , SORT_DESC )); // Sort by oldest first print_r ( array_sort ( $people , 'surname' , SORT_ASC )); // Sort by surname /* Array ( [12345] => Array ( [id] => 12345 [first_name] => Joe [surname] => Bloggs [age] => 23 [sex] => m ) [12347] => Array ( [id] => 12347 [first_name] => Amy [surname] => Jones [age] => 21 [sex] => f ) [12346] => Array ( [id] => 12346 [first_name] => Adam [surname] => Smith [age] => 18 [sex] => m ) ) Array ( [12345] => Array ( [id] => 12345 [first_name] => Joe [surname] => Bloggs [age] => 23 [sex] => m ) [12347] => Array ( [id] => 12347 [first_name] => Amy [surname] => Jones [age] => 21 [sex] => f ) [12346] => Array ( [id] => 12346 [first_name] => Adam [surname] => Smith [age] => 18 [sex] => m ) ) */ ?> up down 13 Walter Tross ¶ 14 years ago unless you specify the second argument, "regular" comparisons will be used.
I quote from the page on comparison operators: "If you compare a number with a string or the comparison involves numerical strings, then each string is converted to a number and the comparison performed numerically." What this means is that "10" < "1a", and "1a" < "2", but "10" > "2". In other words, regular PHP string comparisons are not transitive. This implies that the output of sort() can in rare cases depend on the order of the input array: <?php function echo_sorted ( $a ) { echo " { $a [ 0 ]} { $a [ 1 ]} { $a [ 2 ]} " ; sort ( $a ); echo " => { $a [ 0 ]} { $a [ 1 ]} { $a [ 2 ]} \n" ; } // on PHP 5.2.6: echo_sorted (array( "10" , "1a" , "2" )); // => 10 1a 2 echo_sorted (array( "10" , "2" , "1a" )); // => 1a 2 10 echo_sorted (array( "1a" , "10" , "2" )); // => 2 10 1a echo_sorted (array( "1a" , "2" , "10" )); // => 1a 2 10 echo_sorted (array( "2" , "10" , "1a" )); // => 2 10 1a echo_sorted (array( "2" , "1a" , "10" )); // => 10 1a 2 ?> up down 3 aminkhoshzahmat at gmail dot com ¶ 6 years ago Let's say we have a list of names, and it is not sorted. <?php $names = array( 'Amin' , 'amir' , 'sarah' , 'Somayeh' , 'armita' , 'Armin' ); sort ( $names ); // simple alphabetical sort print_r ( $names ); ?> Result is : Array ( [0] => Amin [1] => Armin [2] => Somayeh // actually it's not sort alphabetically from here! [3] => amir // comparison is based on ASCII values. [4] => armita [5] => sarah ) If you want to sort alphabeticaly no matter it is upper or lower case: <?php sort ( $names , SORT_STRING | SORT_FLAG_CASE ); print_r ( $names ); ?> Result is: Array ( [0] => Amin [1] => amir [2] => Armin [3] => armita [4] => sarah [5] => Somayeh ) up down 1 Md.
Abutaleb ¶ 6 years ago <?php /* As I found the sort() function normally works as ascending order based on the following priority : 1. NULL 2. Empty 3. Boolean FALSE 4. String 5. Float 6. Int 7. Array 8. Object Consider the following array: */ $a = [ 'fruit' => 'apple' , 'A' => 10 , 20 , 5 , 2.5 , 5 => 'A new value' , 'last' => 'value' , TRUE , NULL , "" , FALSE , array(), new StdClass ]; sort ( $a ); var_dump ( $a ); #The output is: array( 13 ) { [ 0 ]=> NULL [ 1 ]=> string ( 0 ) "" [ 2 ]=> bool ( false ) [ 3 ]=> string ( 11 ) "A new value" [ 4 ]=> string ( 5 ) "apple" [ 5 ]=> string ( 5 ) "value" [ 6 ]=> float ( 2.5 ) [ 7 ]=> int ( 5 ) [ 8 ]=> int ( 10 ) [ 9 ]=> int ( 20 ) [ 10 ]=>array( 0 ) { } [ 11 ]=> bool ( true ) [ 12 ]=> object ( stdClass ) #1 (0) {} } //Hope it will remove your confusion when you're sorting an array with mix type data. ?> up down 1 Abhishek Banerjee ¶ 10 years ago EDIT: To the original note by "phpdotnet at m4tt dot co dot uk" Use array_push instead of $new_array[$k] for some reason it was giving me string indexes.
Simple function to sort an array by a specific key. Maintains index association. <?php function array_sort ( $array , $on , $order = SORT_ASC ) { $new_array = array(); $sortable_array = array(); if ( count ( $array ) > 0 ) { foreach ( $array as $k => $v ) { if ( is_array ( $v )) { foreach ( $v as $k2 => $v2 ) { if ( $k2 == $on ) { $sortable_array [ $k ] = $v2 ; } }
The rest of this page is on the live site.