usort
(PHP 4, PHP 5, PHP 7)
usort - 使用用户定义的比较函数按值排序数组
描述
bool usort ( array &$array , callable $value_compare_func )
该函数将使用用户提供的比较函数按值排序数组。如果你想排序的数组需要按照一些非平凡的标准进行排序,你应该使用这个函数。
注意:如果两个成员比较相等,则它们在已排序数组中的相对顺序是未定义的。
注意:此函数为新元素分配新元素
array
。它将删除可能已分配的所有现有密钥,而不仅仅是重新排序密钥。
参数
array
输入数组。
value_compare_func
如果第一个参数分别小于,等于或大于第二个参数,则比较函数必须返回小于,等于或大于零的整数。请注意,在PHP 7.0.0之前,此整数必须在-2147483648到2147483647之间。
int callback ( mixed $a, mixed $b )
警告
从比较函数返回非整数值(如float)将导致内部转换为回调的返回值的整数。因此,诸如0.99和0.1之类的值都将被转换为0的整数值,这将比较这些值相等。
返回值
TRUE
成功或FALSE
失败时返回。
例子
示例#1 usort()示例
<?php
function?cmp($a,?$b)
{
????if?($a?==?$b)?{
????????return?0;
????}
????return?($a?<?$b)???-1?:?1;
}
$a?=?array(3,?2,?5,?6,?1);
usort($a,?"cmp");
foreach?($a?as?$key?=>?$value)?{
????echo?"$key:?$value\n";
}
?>
上面的例子将输出:
0: 1
1: 2
2: 3
3: 5
4: 6
注意:显然在这个微不足道的情况下,sort()函数会更合适。
示例#2使用多维数组的usort()示例
<?php
function?cmp($a,?$b)
{
????return?strcmp($a["fruit"],?$b["fruit"]);
}
$fruits[0]["fruit"]?=?"lemons";
$fruits[1]["fruit"]?=?"apples";
$fruits[2]["fruit"]?=?"grapes";
usort($fruits,?"cmp");
while?(list($key,?$value)?=?each($fruits))?{
????echo?"\$fruits[$key]:?"?.?$value["fruit"]?.?"\n";
}
?>
排序多维数组时,$ a和$ b包含对数组第一个索引的引用。
上面的例子将输出:
$fruits[0]: apples
$fruits[1]: grapes
$fruits[2]: lemons
示例#3 usort()示例使用对象的成员函数
<?php
class?TestObj?{
????var?$name;
????function?TestObj($name)
????{
????????$this->name?=?$name;
????}
????/*?This?is?the?static?comparing?function:?*/
????static?function?cmp_obj($a,?$b)
????{
????????$al?=?strtolower($a->name);
????????$bl?=?strtolower($b->name);
????????if?($al?==?$bl)?{
????????????return?0;
????????}
????????return?($al?>?$bl)???+1?:?-1;
????}
}
$a[]?=?new?TestObj("c");
$a[]?=?new?TestObj("b");
$a[]?=?new?TestObj("d");
usort($a,?array("TestObj",?"cmp_obj"));
foreach?($a?as?$item)?{
????echo?$item->name?.?"\n";
}
?>
上面的例子将输出:
b
c
d
示例#4使用 闭包 对一个多维数组进行排序的usort()示例
<?php
$array[0]?=?array('key_a'?=>?'z',?'key_b'?=>?'c');
$array[1]?=?array('key_a'?=>?'x',?'key_b'?=>?'b');
$array[2]?=?array('key_a'?=>?'y',?'key_b'?=>?'a');
function?build_sorter($key)?{
????return?function?($a,?$b)?use?($key)?{
????????return?strnatcmp($a[$key],?$b[$key]);
????};
}
usort($array,?build_sorter('key_b'));
foreach?($array?as?$item)?{
????echo?$item['key_a']?.?',?'?.?$item['key_b']?.?"\n";
}
?>
上面的例子将输出:
y, a
x, b
z, c
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com