sort

(PHP 4, PHP 5, PHP 7, PHP 8)

sort — 對數(shù)組升序排序

說明

sort(array &$array, int $flags = SORT_REGULAR): bool

對 array 本身按照值（value）升序排序。

注意:

如果兩個成員完全相同，那么它們將保持原來的順序。 在 PHP 8.0.0 之前，它們在排序數(shù)組中的相對順序是未定義的。

注意: 此函數(shù)為 array 中的元素賦與新的鍵名。這將刪除原有的鍵名，而不是僅僅將鍵名重新排序。

注意:

重置數(shù)組中的內(nèi)部指針，指向第一個元素。

參數(shù)

array

輸入的數(shù)組。

flags

可選的第二個參數(shù) flags 可以用以下值改變排序的行為：

排序類型標記：

  • SORT_REGULAR - 正常比較單元 詳細描述參見 比較運算符 章節(jié)
  • SORT_NUMERIC - 單元被作為數(shù)字來比較
  • SORT_STRING - 單元被作為字符串來比較
  • SORT_LOCALE_STRING - 根據(jù)當前的區(qū)域（locale）設置來把單元當作字符串比較，可以用 setlocale() 來改變。
  • SORT_NATURAL - 和 natsort() 類似對每個單元以“自然的順序”對字符串進行排序。
  • SORT_FLAG_CASE - 能夠與 SORT_STRING 或 SORT_NATURAL 合并（OR 位運算），不區(qū)分大小寫排序字符串。

返回值

總是返回 true 。

范例

示例 #1 sort() 例子

<?php

$fruits = array("lemon", "orange", "banana", "apple");
sort($fruits);
foreach ($fruits as $key => $val) {
    echo "fruits[" . $key . "] = " . $val . "\n";
}

?>

以上例程會輸出：

fruits[0] = apple
fruits[1] = banana
fruits[2] = lemon
fruits[3] = orange

fruits 被按照字母順序排序。

示例 #2 使用 sort() 不區(qū)分大小寫自然排序的例子

<?php

$fruits = array(
    "Orange1", "orange2", "Orange3", "orange20"
);
sort($fruits, SORT_NATURAL | SORT_FLAG_CASE);
foreach ($fruits as $key => $val) {
    echo "fruits[" . $key . "] = " . $val . "\n";
}

?>

以上例程會輸出：

fruits[0] = Orange1
fruits[1] = orange2
fruits[2] = Orange3
fruits[3] = orange20

fruits 排序得像 natcasesort() 的結(jié)果。

注釋

注意: 和大多數(shù) PHP 排序函數(shù)一樣，sort() 使用了 ? 快速排序 實現(xiàn)的。 在已排序的數(shù)組分片的中間，選擇基準值，具有最優(yōu)時間。 但不應該依賴它實現(xiàn)的細節(jié)。

警告

在對含有混合類型值的數(shù)組 以 flags 為 SORT_REGULAR 排序時要小心，因為 sort() 可能會產(chǎn)生不可預知的結(jié)果。

參見