<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="array.sorting" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>对数组进行排序</title>

<para>

PHP 有一些用来排序数组的函数，

这个文档会把它们列出来。

</para>

<para>

主要区别有：

</para>

<para>

<simplelist>

<member>

有些函数基于 <type>array</type> 的键来排序，

而其他的基于值来排序的：<literal>$array['key'] = 'value';</literal>。

</member>

<member>

排序之后键和值之间的关联关系是否能够保持，

是指排序之后数组的键可能

会被重置为数字型的（0,1,2 ...）。

</member>

<member>

排序的顺序有：字母表顺序， 升序（由低到高），

降序（由高到低），数字排序，自然排序，随机顺序或者用户自定义排序。

</member>

<member>

注意：下列的所有排序函数都是直接作用于数组本身，

而不是返回一个新的有序的数组。

</member>

<member>

以下函数对于数组中相等的元素，会保留原有的排序。

在 PHP 8.0.0 之前，它们排序后的顺序是未定义的（也即相等元素之间的顺序是不稳定的）。

</member>

</simplelist>

</para>

<para>

<table>

<title>排序函数属性</title>

<tgroup cols="5">

<thead>

<row>

<entry>函数名称</entry>

<entry>排序依据</entry>

<entry>数组索引键保持</entry>

<entry>排序的顺序</entry>

<entry>相关函数</entry>

</row>

</thead>

<tbody>

<row>

<entry><function>array_multisort</function></entry>

<entry>值</entry>

<entry><type>string</type> 键保持不变，<type>int</type> 键重新索引</entry>

<entry>第一个数组或者由选项指定</entry>

<entry><function>array_walk</function></entry>

</row>

<row>

<entry><function>asort</function></entry>

<entry>值</entry>

<entry>是</entry>

<entry>升序</entry>

<entry><function>arsort</function></entry>

</row>

<row>

<entry><function>arsort</function></entry>

<entry>值</entry>

<entry>是</entry>

<entry>降序</entry>

<entry><function>asort</function></entry>

</row>

<row>

<entry><function>krsort</function></entry>

<entry>键</entry>

<entry>是</entry>

<entry>降序</entry>

<entry><function>ksort</function></entry>

</row>

<row>

<entry><function>ksort</function></entry>

<entry>键</entry>

<entry>是</entry>

<entry>升序</entry>

<entry><function>krsort</function></entry>

</row>

<row>

<entry><function>natcasesort</function></entry>

<entry>值</entry>

<entry>是</entry>

<entry>自然排序，大小写不敏感</entry>

<entry><function>natsort</function></entry>

</row>

<row>

<entry><function>natsort</function></entry>

<entry>值</entry>

<entry>是</entry>

<entry>自然排序</entry>

<entry><function>natcasesort</function></entry>

</row>

<row>

<entry><function>rsort</function></entry>

<entry>值</entry>

<entry>否</entry>

<entry>降序</entry>

<entry><function>sort</function></entry>

</row>

<row>

<entry><function>shuffle</function></entry>

<entry>值</entry>

<entry>否</entry>

<entry>随机</entry>

<entry><function>array_rand</function></entry>

</row>

<row>

<entry><function>sort</function></entry>

<entry>值</entry>

<entry>否</entry>

<entry>升序</entry>

<entry><function>rsort</function></entry>

</row>

<row>

<entry><function>uasort</function></entry>

<entry>值</entry>

<entry>是</entry>

<entry>由用户定义</entry>

<entry><function>uksort</function></entry>

</row>

<row>

<entry><function>uksort</function></entry>

<entry>键</entry>

<entry>是</entry>

<entry>由用户定义</entry>

<entry><function>uasort</function></entry>

</row>

<row>

<entry><function>usort</function></entry>

<entry>值</entry>

<entry>否</entry>

<entry>由用户定义</entry>

<entry><function>uasort</function></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</chapter>