請注意,介於 (-1, 1) 之間的返回值會被視為 0。
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
ArrayObject::uasort — 使用使用者自訂的比較函式排序項目,並保留鍵值關聯
此函式使用使用者自訂的比較函式排序條目,讓鍵值維持與其關聯條目的對應關係。
這主要用於排序關聯式陣列,其中實際元素的順序很重要。
注意:
如果兩個成員比較結果相等,它們會保留其原始順序。在 PHP 8.0.0 之前,它們在已排序陣列中的相對順序未定義。
callback
比較函式必須回傳一個整數,如果第一個參數分別小於、等於或大於第二個參數,則回傳值應小於、等於或大於零。
總是回傳 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) } }