PHP: usort() function

PHP: Sort an array by values using a user-defined comparison function

The usort() function is used to sort an array by its values using a user-defined comparison function. If the array you wish to sort needs to be sorted by some non-trivial criteria, you should use this function.
The function removes any existing keys and assigns new keys for the elements in the array.


(PHP 4 and above)


usort(array_name, user-defined-function)


Name Description Required /
array_name The specified array which will be sorted. Required Array
user-defined-function User define function. Required

Return value:

TRUE on success, or FALSE on failure.

Value Type: Boolean.


function user_compare($x, $y)
if ($x == $y)
return 0;
else if ($x > $y)
return 1;
return -1;
$array1 = array(22,33,66,55,11);
usort($array1, 'user_compare');
foreach($array1 as $key => $value)
echo "$key: $value\n";

Sample Output:

0: 11  1: 22  2: 33  3: 55  4: 66 

Pictorial Presentation:

php function reference: usort() function

View the example in the browser

Practice here online:

See also

PHP Function Reference

Previous: uksort
Next: Calendar Functions cal_days_in_month

Follow us on Facebook and Twitter for latest update.