Start · Sprachen · PHP · Referenz · usort

usort

Funktion

Sortiert ein Array mit einer benutzerdefinierten Vergleichsfunktion — die flexibelste Sortier-Option.

seit PHP 4.0.0 Kategorie: array

Signatur

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

Beschreibung

Der Callback bekommt zwei Elemente und muss -1, 0 oder 1 zurückgeben. Der Spaceship-Operator (<=>) ist ideal dafür.

Parameter

Name Typ Default Beschreibung
$array Pflicht array& Array (Referenz).
$callback Pflicht callable Vergleichsfunktion.

Rückgabewert

Typ
true
Beschreibung
Immer true.

Beispiele

Nach Feld sortieren

<?php

$users = [
    ['name' => 'Ben',  'age' => 35],
    ['name' => 'Anna', 'age' => 28],
];
usort($users, fn($a, $b) => $a['age'] <=> $b['age']);
// Anna (28), Ben (35)

Mehrfach-Sort

<?php

usort($users, fn($a, $b) =>
    [$a['prio'], $a['name']] <=> [$b['prio'], $b['name']]
);