ArrayIterator::uasort

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

ArrayIterator::uasort — Sort with a user-defined comparison function and maintain index association

Beschreibung

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

This method sorts the elements such that indices maintain their correlation with the values they are associated with, using a user-defined comparison function.

Hinweis:
Wenn zwei Mitglieder als identisch verglichen werden, behalten sie ihre ursprüngliche Reihenfolge bei. Vor PHP 8.0.0 war die relative Sortierung im sortierten Array nicht definiert.

Parameter-Liste

callback: Die Vergleichsfunktion muss einen Integer kleiner als, gleich oder größer als Null zurückgeben, wenn das erste Argument respektive kleiner, gleich oder größer als das zweite ist.

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

Achtung
Wenn die Vergleichsfunktion nicht-ganzzahlige Werte zurückgibt, z. B. vom Typ float, wird der Rückgabewert des Callbacks intern in den Typ int umgewandelt. Werte wie 0.99 und 0.1 werden also beide in einen Integer-Wert von 0 umgewandelt, wodurch diese Werte als gleichwertig eingestuft werden.

Rückgabewerte

Gibt immer true zurück.

Changelog

Version	Beschreibung
8.2.0	Der Rückgabewert ist nun `true` vorher war es bool.

Siehe auch

ArrayIterator::asort() - Sort entries by values
ArrayIterator::ksort() - Sort entries by keys
ArrayIterator::natcasesort() - Sort entries naturally, case insensitive
ArrayIterator::natsort() - Sort entries naturally
ArrayIterator::uksort() - Sort by keys using a user-defined comparison function
uasort() - Sortiert ein Array mittels einer benutzerdefinierten Vergleichsfunktion und behält Index-Assoziationen bei

add a note

User Contributed Notes 1 note

down

Massimiliano Arione ¶

8 years ago


Even if documentation says that $cmp_function must be a string, this method works with a Callable also.
Example:

<?php

$iterator->uasort([$this, 'usort']);  // 'usort' here is a method in the same class

add a note