asort
(PHP 4, PHP 5, PHP 7, PHP 8)
asort — Sortiert ein Array in aufsteigender Reihenfolge und behält die Indexzuordnung bei
Beschreibung
&$array
, int $flags
= SORT_REGULAR
): bool
Sortiert array
in aufsteigender Reihenfolge so, dass
der Zusammenhang zwischen den Schlüsseln und den Werten, die ihnen
zugeordnet sind, erhalten bleibt.
Dies wird hauptsächlich zur Sortierung assoziativer Arrays verwendet, bei denen die aktuelle Reihenfolge der Elemente von Bedeutung ist.
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.
Hinweis:
Setzt den internen Zeiger des Arrays auf das erste Element zurück.
Parameter-Liste
-
array
-
Das Eingabe-Array.
-
flags
-
Der optionale zweite Parameter
flags
kann mit folgenden Werten genutzt werden, um das Sortierverhalten zu ändern:Flags für den Sortiertyp:
-
SORT_REGULAR
- vergleicht Elemente normal; die Details sind dem Abschnitt über Vergleichsoperatoren zu entnehmen. -
SORT_NUMERIC
- vergleicht Elemente numerisch. -
SORT_STRING
- vergleicht Elemente als Zeichenketten. -
SORT_LOCALE_STRING
- vergleicht Elemente als Zeichenketten, basierend auf den aktuellen Locale-Einstellungen. Es wird die Locale verwendet, die mit setlocale() geändert werden kann. -
SORT_NATURAL
- vergleicht Elemente als Zeichenketten wie natsort() mit "natürlicher Ordnung". -
SORT_FLAG_CASE
- kann kombiniert werden (bitweise ODER) mitSORT_STRING
oderSORT_NATURAL
, um Zeichenketten unter Berücksichtigung der Groß- und Kleinschreibung zu sortieren.
-
Rückgabewerte
Gibt immer true
zurück.
Beispiele
Beispiel #1 asort()-Beispiel
<?php
$fruits = array("d" => "Zitrone", "a" => "Orange", "b" => "Banane", "c" => "Apfel");
asort($fruits);
foreach ($fruits as $key => $val) {
echo "$key = $val\n";
}
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
c = Apfel b = Banane a = Orange d = Zitrone
Die Früchte wurden in alphabetischer Reihenfolge sortiert und die Zuordnung zwischen Indizes und Elementen blieb erhalten.
Siehe auch
- sort() - Sortiert ein Array in aufsteigender Reihenfolge
- arsort() - Sortiert ein Array in absteigender Reihenfolge und behält die Indexzuordnung bei
- Den Vergleich von Arraysortierungsfunktionen