(PHP 4, PHP 5, PHP 7, PHP 8)
ksort — Sortiert ein Array nach Schlüsseln in aufsteigender Reihenfolge
Sortiert array
nach Schlüsseln in aufsteigender
Reihenfolge.
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.
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 werden im Abschnitt
Vergleichsoperatoren
beschrieben.
SORT_NUMERIC
- vergleicht Elemente numerisch.
SORT_STRING
- vergleicht Elemente als Zeichenketten.
SORT_LOCALE_STRING
- vergleicht Elemente als
Zeichenketten, basierend auf dem aktuellen Gebietsschema. Es wird das
Gebietsschema verwendet, das 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) mit SORT_STRING
oder
SORT_NATURAL
, um Zeichenketten ohne
Berücksichtigung der Groß- und Kleinschreibung zu sortieren.
Gibt immer true
zurück.
Beispiel #1 ksort()-Beispiel
<?php
$fruits = array("d" => "Zitrone", "a" => "Orange", "b" => "Banane", "c" => "Apfel");
ksort($fruits);
foreach ($fruits as $key => $val) {
echo "$key = $val\n";
}
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
a = Orange b = Banane c = Apfel d = Zitrone
Beispiel #2 ksort() mit int-Schlüsseln
<?php
$a = [0 => 'Erstes', 2 => 'Letztes', 1 => 'Mittleres'];
var_dump($a);
ksort($a);
var_dump($a);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(3) { [0]=> string(6) "Erstes" [2]=> string(7) "Letztes" [1]=> string(9) "Mittleres" } array(3) { [0]=> string(6) "Erstes" [1]=> string(9) "Mittleres" [2]=> string(7) "Letztes" }