PHP Manual
Array Funktionen
Sortiert ein Array nach Schlüsseln in aufsteigender Reihenfolge

ksort

(PHP 4, PHP 5, PHP 7, PHP 8)

ksort — Sortiert ein Array nach Schlüsseln in aufsteigender Reihenfolge

Beschreibung

ksort(array &$array, int $flags = SORT_REGULAR): bool

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.

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) mit SORT_STRING oder SORT_NATURAL, um Zeichenketten unter Berücksichtigung der Groß- und Kleinschreibung zu sortieren.

Rückgabewerte

Gibt immer true zurück.

Beispiele

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"
}