array_multisort

适用 PHP 版本

PHP 4, PHP 5, PHP 7, PHP 8

函数说明

array_multisort() 是一个用于对多个数组或多维数组中的多个列进行排序的函数。它可以对一个或多个数组进行排序，并能保持数组之间的索引关系同步。在进行多数组排序时，第一个数组将作为主要排序依据，其余数组依次作为次要排序依据。

函数语法

bool array_multisort(array &$array1, mixed $array1_sort_order = SORT_ASC, mixed $array1_sort_flags = SORT_REGULAR, mixed ...$rest)

参数

• $array1：要排序的第一个数组（通过引用传递）。
• $array1_sort_order（可选）：排序顺序。可选值：
  • SORT_ASC - 升序（默认值）
  • SORT_DESC - 降序
• $array1_sort_flags（可选）：排序类型标志。可选值：
  • SORT_REGULAR - 正常比较（默认）
  • SORT_NUMERIC - 数字比较
  • SORT_STRING - 字符串比较
  • SORT_LOCALE_STRING - 基于本地化字符串比较
  • SORT_NATURAL - 自然顺序排序
  • SORT_FLAG_CASE - 可以与 SORT_STRING 或 SORT_NATURAL 结合使用（忽略大小写）
• ...$rest：可以添加更多的数组及其对应的排序顺序和排序类型。

返回值

成功时返回 true，失败时返回 false。

示例

$names = array("Liam", "Emma", "Noah", "Olivia");
$ages = array(34, 22, 19, 22);
<p>array_multisort($ages, SORT_ASC, $names);</p>
<p>print_r($ages);<br>
print_r($names);<br>

示例代码的说明

这个例子中，$ages 和 $names 是两个相关的数组。我们首先按年龄 $ages 进行升序排序。如果多个元素有相同的年龄（如 22），则使用 $names 进行次级排序。array_multisort() 会同步地重新排序这两个数组，以保持数据之间的对应关系。