array_multisort
Sortiert mehrere oder multidimensionale Arrays
&reftitle.description;
boolarray_multisort
arrayarray1
mixedarray1_sort_orderSORT_ASC
mixedarray1_sort_flagsSORT_REGULAR
mixed...
array_multisort wird zum Sortieren von
entweder mehreren Arrays auf einmal, oder eines
multidimensionalen Arrays nach einer oder mehreren Dimensionen
benutzt.
Assoziative (string) Schlüssel werden beibehalten,
während numerische Schlüssel neu indexiert werden.
&reftitle.parameters;
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, oder SORT_DESC
um absteigend zu sortieren.
Dieses Argument kann mit array1_sort_order vertauscht werden,
oder ganz entfallen, in welchem Fall SORT_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) mit
SORT_STRING oder
SORT_NATURAL um Zeichenketten case-insensitive zu sortieren
Dieses Argument kann mit array1_sort_order vertauscht werden,
oder ganz entfallen, in welchem Fall SORT_REGULAR angenommen wird.
...
Weitere Arrays, optional gefolgt von Sortierreihenfolge und -Flags. Nur
zu äquivalenten Elementen in vorherigen Arrays korrespondiere Elemente
werden verglichen. Anders ausgedrückt erfolgt die Sortierung
lexikografisch.
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&Version;
&Description;
5.4.0
SORT_NATURAL und SORT_FLAG_CASE
wurden zu array1_sort_flags als mögliche Sortier-Flags hinzugefügt.
5.3.0
SORT_LOCALE_STRING wurde zu
array1_sort_flags als mögliches Sortier-Flag hinzugefügt.
&reftitle.examples;
Sortieren mehrerer Arrays
]]>
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), wurden ebenfalls
sortiert.
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)
}
]]>
Sortieren eines mehrdimensionalen Arrays
]]>
In diesem Beispiel wird sich das erste Array nach der Sortierung
in "10", 100, 100, 11, "a" ändern (es wurde als Strings in
aufsteigender Reihenfolge sortiert). Das zweite wird
1, 3, "2", 2, 1 enthalten (sortiert als Zahlen in absteigender Reihe).
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)
}
}
]]>
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:
Die Daten als data genanntes Array. Dieses würde
man üblicherweise erhalten, indem man zum Beispiel mit
mysql_fetch_assoc eine Schleife baut.
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 nach Band absteigend
sortieren und nach Auflage aufsteigend.
Wir haben ein Array von Zeilen, aber
array_multisort benötigt ein Array von Spalten,
daher benutzen wir den Code unten, um die Spalten zu bekommen und
dann die Sortierung durchzuführen.
$row) {
$band[$key] = $row['Band'];
$auflage[$key] = $row['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:
Groß-/Kleinschreibung nicht-beachtende Sortierung
Sowohl SORT_STRING als auch
SORT_REGULAR beachten die Groß-/Kleinschreibung,
weshalb Strings, welche mit großem Buchstaben beginnen, vor Strings
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.
]]>
&example.outputs;
Alpha
[1] => atomar
[2] => bank
[3] => Beta
)
]]>
&reftitle.seealso;
usort
&seealso.array.sorting;