array_multisort
(PHP 4, PHP 5, PHP 7, PHP 8)
array_multisort — Sortiert mehrere oder multidimensionale Arrays
Beschreibung
array
&$array1
,mixed
$array1_sort_order
= SORT_ASC,mixed
$array1_sort_flags
= SORT_REGULAR,mixed
...$rest
): bool
array_multisort() kann verwendet werden, um entweder mehrere Arrays auf einmal zu sortieren, oder ein multidimensionales Array nach einer oder mehreren Dimensionen.
Assoziative (String-) Schlüssel werden beibehalten, während numerische Schlüssel neu indexiert werden.
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
-
array1
-
Ein zu sortierendes Array.
-
array1_sort_order
-
Die Reihenfolge, die verwendet wird, um das vorangehende Array-Argument zu sortieren. Entweder
SORT_ASC
, um aufsteigend zu sortieren, oderSORT_DESC
, um absteigend zu sortieren.Dieses Argument kann mit
array1_sort_flags
vertauscht werden oder ganz entfallen, wobei dannSORT_ASC
angenommen wird. -
array1_sort_flags
-
Sortieroptionen für das vorangehende Array-Argument:
Sortier-Flags:
-
SORT_REGULAR
- vergleiche Elemente normal (ändere nicht die Typen) -
SORT_NUMERIC
- vergleiche Elemente numerisch -
SORT_STRING
- vergleiche Elemente als Zeichenketten -
SORT_LOCALE_STRING
- vergleiche Elemente als Zeichenketten, basierend auf dem aktuellen Gebietschema. Es verwendet das Gebietsschema, das unter Verwendung von setlocale() geändert werden kann -
SORT_NATURAL
- vergleiche Elemente als Zeichenketten unter Verwendung einer "natürlichen Ordnung" wie natsort() -
SORT_FLAG_CASE
- kann kombiniert werden (bitweises OR) mitSORT_STRING
oderSORT_NATURAL
, um Zeichenketten ohne Berücksichtigung der Groß- und Kleinschreibung zu sortieren
Dieses Argument kann mit
array1_sort_order
vertauscht werden oder ganz entfallen, wobei dannSORT_REGULAR
angenommen wird. -
-
rest
-
Weitere Arrays, optional gefolgt von Sortierreihenfolge und -Flags. Nur Elemente, die äquivalenten Elementen in vorherigen Arrays entsprechen, werden verglichen. Anders ausgedrückt erfolgt die Sortierung lexikographisch.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Beispiele
Beispiel #1 Sortieren mehrerer Arrays
<?php
$ar1 = array(10, 100, 100, 0);
$ar2 = array(1, 3, 2, 4);
array_multisort($ar1, $ar2);
var_dump($ar1);
var_dump($ar2);
?>
In diesem Beispiel enthält das erste Array nach dem Sortieren 0, 10, 100, 100. Das zweite Array wird 4, 1, 2, 3 enthalten. Die Einträge des zweiten Arrays, welche den identischen Einträgen des ersten Arrays entsprechen (100 und 100), werden ebenfalls sortiert.
array(4) { [0]=> int(0) [1]=> int(10) [2]=> int(100) [3]=> int(100) } array(4) { [0]=> int(4) [1]=> int(1) [2]=> int(2) [3]=> int(3) }
Beispiel #2 Sortieren eines mehrdimensionalen Arrays
<?php
$ar = array(
array("10", 11, 100, 100, "a"),
array( 1, 2, "2", 3, 1)
);
array_multisort($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
var_dump($ar);
?>
In diesem Beispiel wird sich das erste Array nach der Sortierung in "10", 100, 100, 11, "a" ändern (es wurde als Zeichenketten in aufsteigender Reihenfolge sortiert). Das zweite wird 1, 3, "2", 2, 1 enthalten (sortiert als Zahlen in absteigender Reihenfolge).
array(2) { [0]=> array(5) { [0]=> string(2) "10" [1]=> int(100) [2]=> int(100) [3]=> int(11) [4]=> string(1) "a" } [1]=> array(5) { [0]=> int(1) [1]=> int(3) [2]=> string(1) "2" [3]=> int(2) [4]=> int(1) } }
Beispiel #3 Datenbankdaten sortieren
In diesem Beispiel repräsentiert jedes Element des Arrays data eine Zeile einer Tabelle. Dieser Typ von Datensätzen ist typisch für Datenbankinhalte.
Beispieldaten:
Band | Auflage -------+-------- 67 | 2 86 | 1 85 | 6 98 | 2 86 | 6 67 | 7
Die Daten als data genanntes Array. Dieses würde man üblicherweise mit einer Schleife über die Ergebnisse von mysql_fetch_assoc() erhalten.
<?php
$data[] = array('Band' => 67, 'Auflage' => 2);
$data[] = array('Band' => 86, 'Auflage' => 1);
$data[] = array('Band' => 85, 'Auflage' => 6);
$data[] = array('Band' => 98, 'Auflage' => 2);
$data[] = array('Band' => 86, 'Auflage' => 6);
$data[] = array('Band' => 67, 'Auflage' => 7);
?>
In diesem Beispiel werden wir absteigend nach Band sortieren und aufsteigend nach Auflage.
Wir haben ein Array von Zeilen, aber array_multisort() benötigt ein Array von Spalten, also benutzen wir den Code unten, um die Spalten zu bekommen und dann die Sortierung durchzuführen.
<?php
// Hole eine Liste von Spalten
foreach ($data as $key => $row) {
$band[$key] = $row['Band'];
$auflage[$key] = $row['Auflage'];
}
// statt des obigen Codes kann array_column() verwendet werden
$band = array_column($data, 'Band');
$auflage = array_column($data, 'Auflage');
// Die Daten mit 'Band' absteigend, die mit 'Auflage' aufsteigend sortieren.
// Geben Sie $data als letzten Parameter an, um nach dem gemeinsamen
// Schlüssel zu sortieren.
array_multisort($band, SORT_DESC, $auflage, SORT_ASC, $data);
?>
Der Datensatz ist jetzt sortiert und wird wie folgt aussehen:
Band | Auflage -----+-------- 98 | 2 86 | 1 86 | 6 85 | 6 67 | 2 67 | 7
Beispiel #4 Groß-/Kleinschreibung nicht-beachtende Sortierung
Sowohl SORT_STRING
als auch
SORT_REGULAR
beachten die Groß-/Kleinschreibung,
weshalb Zeichenketten, welche mit großem Buchstaben beginnen, vor
Zeichenketten einsortiert werden, die mit kleinem Buchstaben anfangen.
Um eine Suche durchzuführen, die die Groß-/Kleinschreibung nicht beachtet, muss man erzwingen, dass die Sortierreihenfolge von einer Kopie des Originalarrays in Kleinschreibung festgelegt wird.
<?php
$array = array('Alpha', 'atomar', 'Beta', 'bank');
$array_lowercase = array_map('strtolower', $array);
array_multisort($array_lowercase, SORT_ASC, SORT_STRING, $array);
print_r($array);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => Alpha [1] => atomar [2] => bank [3] => Beta )
Siehe auch
- usort() - Sortiert ein Array nach Werten mittels einer benutzerdefinierten Vergleichsfunktion
- Den Vergleich von Arraysortierungsfunktionen