2024 年 PHP 日本研討會

ArrayObject::uasort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

ArrayObject::uasort使用使用者自訂的比較函式排序項目,並保留鍵值關聯

說明

public ArrayObject::uasort(可呼叫的 $callback): true

此函式使用使用者自訂的比較函式排序條目,讓鍵值維持與其關聯條目的對應關係。

這主要用於排序關聯式陣列,其中實際元素的順序很重要。

注意:

如果兩個成員比較結果相等,它們會保留其原始順序。在 PHP 8.0.0 之前,它們在已排序陣列中的相對順序未定義。

參數

callback

比較函式必須回傳一個整數,如果第一個參數分別小於、等於或大於第二個參數,則回傳值應小於、等於或大於零。

callback(混合 $a, 混合 $b): int
警告

從比較函式回傳*非整數*值,例如 浮點數,將導致回呼函式回傳值被內部強制轉換為 int。因此,諸如 0.990.1 之類的值都將被強制轉換為整數值 0,這將會導致這些值被比較為相等。

回傳值

總是回傳 true

更新日誌

版本 說明
8.2.0 回傳值類型現在是 true;之前是 布林值

範例

範例 #1 ArrayObject::uasort() 範例

<?php
// 比較函式
function cmp($a, $b) {
if (
$a == $b) {
return
0;
}
return (
$a < $b) ? -1 : 1;
}

// 要排序的陣列
$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
$arrayObject = new ArrayObject($array);
var_dump($arrayObject);

// 排序並印出結果陣列
$arrayObject->uasort('cmp');
var_dump($arrayObject);
?>

以上範例會輸出

object(ArrayObject)#1 (1) {
  ["storage":"ArrayObject":private]=>
  array(8) {
    ["a"]=>
    int(4)
    ["b"]=>
    int(8)
    ["c"]=>
    int(-1)
    ["d"]=>
    int(-9)
    ["e"]=>
    int(2)
    ["f"]=>
    int(5)
    ["g"]=>
    int(3)
    ["h"]=>
    int(-4)
  }
}
object(ArrayObject)#1 (1) {
  ["storage":"ArrayObject":private]=>
  array(8) {
    ["d"]=>
    int(-9)
    ["h"]=>
    int(-4)
    ["c"]=>
    int(-1)
    ["e"]=>
    int(2)
    ["g"]=>
    int(3)
    ["a"]=>
    int(4)
    ["f"]=>
    int(5)
    ["b"]=>
    int(8)
  }
}

另請參閱

新增註解

使用者貢獻的註解 1 則註解

poxetinho at gmail dot com
13 年前
請注意,介於 (-1, 1) 之間的返回值會被視為 0。
To Top