Sortiert mehrere oder multidimensionale Arrays

# array_multisort

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

array_multisort — Sortiert mehrere oder multidimensionale Arrays

### Beschreibung

function array_multisort(
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, oder `SORT_DESC`, um absteigend zu sortieren.

  Dieses Argument kann mit `array1_sort_flags` vertauscht werden oder ganz entfallen, wobei dann `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 ohne Berücksichtigung der Groß- und Kleinschreibung zu sortieren

  Dieses Argument kann mit `array1_sort_order` vertauscht werden oder ganz entfallen, wobei dann `SORT_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.

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
    // Die Daten, die durch eine Schleife über mysqli_fetch_assoc erstellt wurden:
    $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);

    // 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);

    // Durchlaufe die Daten und gib die sortierten Werte für jede Spalte aus
    echo 'Band | Auflage', PHP_EOL;
    echo '-----+--------', PHP_EOL;
    for ($i = 0; $i < count($data); $i++) {
         printf("%6d | %7d\n", $band[$i], $auflage[$i]);
    }
    ?>

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open