Funkcja PHP uksort()

Funkcja PHP uksort() sortuje przekazaną jej jako argument tablicę według kluczy za pomocą funkcji porównywania zdefiniowanej przez użytkownika (funkcji zwrotnej). Funkcja ta przyjmuje tablicę przez referencję, a więc sortuje oryginalną strukturę danych, a nie jej kopię.

Jeśli funkcja uksort() napotka dwa takie same elementy, to pozostawia ich względne ułożenie bez zmian.

Przykład

Sortowanie tablicy według kluczy za pomocą funkcji PHP uksort().


$test = [247, 43, 115];
uksort($test, fn($a, $b) => $b <=> $a);

Wynik:

Array
(
    [2] => 115
    [1] => 43
    [0] => 247
)

W tym przykładzie do porównywania kluczy została użyta funkcja strzałkowa PHP, której działanie opiera się na operatorze statek kosmiczny.

Składnia funkcji PHP uksort()

Funkcja PHP uksort() ma następującą składnię:

uksort(array &$array, callable $callback): true

Parametry

Parametr Opis

array Parametr obowiązkowy. Tablica PHP do posortowania.

Parametr	Opis
`array`	Parametr obowiązkowy. Tablica PHP do posortowania.
`callback`	Funkcja porównująca, która musi zwracać jedną z następujących wartości: Liczba całkowita mniejsza od zera, jeśli pierwszy argument jest mniejszy od drugiego 0, jeśli argumenty są równe — w takim przypadku funkcja nie zmienia ich pierwotnej kolejności Liczba całkowita większa od zera, jeśli pierwszy argument jest większy od drugiego Prototyp funkcji wywołania zwrotnego: `callback(mixed $a, mixed $b): int`

callback

Funkcja porównująca, która musi zwracać jedną z następujących wartości:

Liczba całkowita mniejsza od zera, jeśli pierwszy argument jest mniejszy od drugiego
0, jeśli argumenty są równe — w takim przypadku funkcja nie zmienia ich pierwotnej kolejności
Liczba całkowita większa od zera, jeśli pierwszy argument jest większy od drugiego

Prototyp funkcji wywołania zwrotnego:

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

Wartość zwrotna

Funkcja PHP uksort() zawsze zwraca wartość logiczną true.

Typ zwrotny: bool.

Składnia funkcji PHP uksort()

Parametry

Wartość zwrotna

Zobacz również

Dodaj komentarz Anuluj pisanie odpowiedzi