Funkcja PHP usort() sortuje tablicę według wartości, wykorzystując funkcję porównywania zdefiniowaną przez użytkownika i przekazaną jej jako wywołanie zwrotne.
Funkcja usort() przypisuje sortowanym elementom tablicy nowe klucze, a więc usuwa pierwotne, jeśli istniały.
Składnia funkcji PHP usort()
Funkcja PHP usort() ma następującą składnię:
usort(array &$array, callable $callback): trueParametry
| Parametr | Opis |
|---|---|
| array | Parametr obowiązkowy. Tablica do posortowania. |
| callback | Parametr obowiązkowy. Funkcja wywołania zwrotnego, która ma użyta do porównywania elementów sortowanej tablicy. Należy przekazać jej nazwę jako łańcuch i powinna ona zwracać następujące wartości:
Prototyp funkcji wywołania zwrotnego: |
Wartość zwrotna
Funkcja PHP usort() zawsze zwraca wartość logiczną true.
Typ zwrotny: bool.
Dodatkowe przykłady
Przykład przedstawiony na początku strony wykorzystuje operator PHP statek kosmiczny i funkcję strzałkową, dzięki czemu jest bardzo zwięzły. Poniżej znajduje się ta sama funkcja, tylko z funkcją zwrotną zaimplementowaną w mniej zwięzły sposób.
function cmp($val1, $val2)
{
if ($val1 < $val2) return -1;
if ($val1 == $val2) return 0;
if ($val1 > $val2) return 1;
}
usort($values, "cmp");