usort
Sortiert ein Array nach Werten mittels einer benutzerdefinierten
Vergleichsfunktion.
Beschreibung
boolusort
arrayarray
callbackcmp_function
Diese Funktion sortiert ein Array nach seinen Werten mittels
einer benutzerdefinierten Vergleichsfunktion. Soll das Array nach
nicht trivialen Kriterien sortiert werden, sollten Sie diese
Funktion verwenden.
Die Vergleichsfunktion muss einen Integer zurückgeben, der
kleiner, gleich, oder größer ist als &null;, wenn für das erste
Argument auch angenommen wird, dass es kleiner, gleich, oder
größer ist als das zweite.
Sind zwei Elemente gleich, ist deren Reihenfolge nicht definiert. Bis zu
PHP 4.0.6 würde die benutzerdefinierte Funktion die originäre Reihenfolge
beibehalten, doch seit der Einführung des neuen Sortieralgorhythmus mit
4.1.0 ist dies nicht mehr der Fall, da es keine effiziente Lösung dafür
gibt.
¬e.no-key-association;
&return.success;
<function>usort</function>
$value) {
echo "$key: $value\n";
}
?>
]]>
&example.outputs;
Offensichtlich würde sort für diesen
einfachen Fall besser passen.
<function>usort</function> mit einem mehrdimensionalen Array
]]>
Wird ein mehrdimensionales Array sortiert, enthalten $a
und $b Referenzen zu dem ersten Index des Arrays.
&example.outputs;
<function>usort</function> mit Verwendung einer Member Funktion eines Objektes
name = $name;
}
/* Dies ist die statische Vergleichsfunktion: */
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";
}
?>
]]>
&example.outputs;
Siehe auch uasort,
uksort, sort,
asort,
arsort,ksort,
natsort und rsort.