ksort

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

ksort — 對數(shù)組根據(jù)鍵名升序排序

說明

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

對 array 本身進(jìn)行按鍵（key）升序排序。

注意:

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

注意:

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

參數(shù)

array

輸入的數(shù)組。

flags

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

排序類型標(biāo)記：

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

返回值

總是返回 true 。

范例

示例 #1 ksort() 例子

<?php
$fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
ksort($fruits);
foreach ($fruits as $key => $val) {
    echo "$key = $val\n";
}
?>

以上例程會輸出：

a = orange
b = banana
c = apple
d = lemon

示例 #2 對使用 int 鍵的數(shù)組進(jìn)行 ksort()

<?php
$a = [0 => 'First', 2 => 'Last', 1 => 'Middle'];
var_dump($a);
ksort($a);
var_dump($a);
?>

以上例程會輸出：

array(3) {
  [0]=>
  string(5) "First"
  [2]=>
  string(4) "Last"
  [1]=>
  string(6) "Middle"
}
array(3) {
  [0]=>
  string(5) "First"
  [1]=>
  string(6) "Middle"
  [2]=>
  string(4) "Last"
}

參見