PHP Conference Japan 2024

ArrayObject::uasort

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

ArrayObject::uasort使用用户定义的比较函数排序条目并保持键关联

描述

public ArrayObject::uasort(callable $callback): true

此函数使用用户定义的比较函数对条目进行排序,以便键与其关联的条目保持关联。

这主要用于对关联数组进行排序,其中实际元素顺序很重要。

注意:

如果两个成员比较相等,则它们保留其原始顺序。在 PHP 8.0.0 之前,它们在排序数组中的相对顺序未定义。

参数

callback

比较函数必须返回一个小于、等于或大于零的整数,如果第一个参数分别被认为小于、等于或大于第二个参数。

callback(mixed $a, mixed $b): int
注意

从比较函数返回非整数值,例如float,将导致回调返回值内部强制转换为int。因此,诸如0.990.1的值都将强制转换为整数0,这将使这些值被视为相等。

返回值

始终返回true

变更日志

版本 描述
8.2.0 返回类型现在为true;以前是bool

示例

示例 #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