From f8f1e1564b505153b2d668f669ed946bbcc0ba23 Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Thu, 19 Mar 2009 06:06:33 +0000 Subject: [PATCH] Initial commit, a unified document about all of the array sorting functions git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@277465 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/array/sorting.xml | 165 ++++++++++++++++++++++++++++++++++++ 1 file changed, 165 insertions(+) create mode 100644 reference/array/sorting.xml diff --git a/reference/array/sorting.xml b/reference/array/sorting.xml new file mode 100644 index 0000000000..aa0c74ac7b --- /dev/null +++ b/reference/array/sorting.xml @@ -0,0 +1,165 @@ + + + + + Sorting Arrays + + PHP has several functions that deal with sorting arrays, and this + document exists to help sort it all out. + + + The main differences are: + + + + + Some sort based on the array keys, whereas others by + the values: $array['key'] = 'value'; + + + Whether or not the correlation between the keys and values are + maintained after the sort, which may mean the keys are reset + numerically (0,1,2 ...) + + + The order of the sort: alphabetical, low to high (ascending), + high to low (descending), numerical, natural, random, or user defined + + + Note: All of these sort functions act directly on the array + variable itself, as opposed to returning a new sorted array + + + + + + Sorting function attributes + + + + Function name + Sorts by + Maintains key association + Order of sort + Related functions + + + + + array_multisort + value + associative yes, numeric no + first array or sort options + array_walk + + + asort + value + yes + low to high + arsort + + + arsort + value + yes + high to low + asort + + + krsort + key + yes + high to low + ksort + + + ksort + key + yes + low to high + asort + + + natcasesort + value + yes + natural, case insensitive + natsort + + + natsort + value + yes + natural + natcasesort + + + rsort + value + no + high to low + sort + + + shuffle + value + no + random + array_rand + + + sort + value + no + low to high + rsort + + + uasort + value + yes + user defined + uksort + + + uksort + key + yes + user defined + uasort + + + usort + value + no + user defined + uasort + + + +
+ + + + +