Funkcja array_multisort

Funkcja array_multisort pozwala sortować wiele tablic jednocześnie lub wykonywać złożone sortowanie tablic wielowymiarowych według jednego lub wielu kryteriów.

Składnia

phparray_multisort(
  array1, 
  [sorting_order = SORT_ASC], 
  [sorting_type = SORT_REGULAR], 
  array2, 
  array3, 
  ...
);

Parametr sorting_order

Parametr sorting_order określa kierunek sortowania. Oto jego wartości:

Parametr Opis
SORT_ASC Sortowanie rosnąco (wartość domyślna).
SORT_DESC Sortowanie malejąco.

Parametr sorting_type

Parametr sorting_type określa typ porównania elementów. Oto jego wartości:

Parametr Opis
SORT_REGULAR Zwykłe porównanie elementów (domyślnie).
SORT_NUMERIC Numeryczne porównanie elementów.
SORT_STRING Porównanie łańcuchowe elementów.
SORT_LOCALE_STRING Porównanie łańcuchowe z uwzględnieniem bieżącej lokalizacji.
SORT_NATURAL Naturalne sortowanie ciągów (jak w eksploratorze plików).
SORT_FLAG_CASE Łączone z SORT_STRING lub SORT_NATURAL dla sortowania niewrażliwego na wielkość liter.

Przykład

Sortowanie dwóch tablic z określeniem parametrów:

php<?php
  $numbers = [10, 2, 15, 4];
  $letters = ['b', 'a', 'd', 'c'];
  array_multisort(
    $numbers, SORT_DESC, SORT_NUMERIC,
    $letters, SORT_ASC, SORT_STRING
  );
  print_r($numbers);
  print_r($letters);
?>

Wynik wykonania kodu:

php[15, 10, 4, 2]
['d', 'b', 'c', 'a']

Przykład

Sortowanie tablicy wielowymiarowej według określonego pola:

php<?php
  $data = [
    ['name' => 'John', 'age' => 25],
    ['name' => 'Alice', 'age' => 22],
    ['name' => 'Bob', 'age' => 30]
  ];
  
  $ages = array_column($data, 'age');
  array_multisort($ages, SORT_ASC, $data);
  print_r($data);
?>

Wynik wykonania kodu:

php[
  ['name' => 'Alice', 'age' => 22],
  ['name' => 'John', 'age' => 25],
  ['name' => 'Bob', 'age' => 30]
]

Przykład

Sortowanie tablicy wielowymiarowej według dwóch określonych pól:

php<?php
  $data = [
    ['name' => 'John', 'age' => 25],
    ['name' => 'alice', 'age' => 22],
    ['name' => 'Bob', 'age' => 30]
  ];
  
  $names = array_column($data, 'name');
  $ages = array_column($data, 'age');
  array_multisort(
    $names, SORT_ASC, SORT_STRING | SORT_FLAG_CASE,
    $ages, SORT_DESC,
    $data
  );
  print_r($data);
?>

Wynik wykonania kodu:

php[
  ['name' => 'alice', 'age' => 22],
  ['name' => 'Bob', 'age' => 30],
  ['name' => 'John', 'age' => 25]
]

Przykład

Naturalne sortowanie ciągów:

php<?php
  $files = ['file1.txt', 'file10.txt', 'file2.txt'];
  array_multisort($files, SORT_ASC, SORT_NATURAL);
  print_r($files);
?>

Wynik wykonania kodu:

php['file1.txt', 'file2.txt', 'file10.txt']

Przykład

Sortowanie niewrażliwe na wielkość liter:

php<?php
  $words = ['Apple', 'banana', 'cherry', 'apricot'];
  array_multisort($words, SORT_ASC, SORT_STRING | SORT_FLAG_CASE);
  print_r($words);
?>

Wynik wykonania kodu:

php['Apple', 'apricot', 'banana', 'cherry']

Zobacz też

  • funkcję sort,
    która sortuje rosnąco według elementów
  • funkcję rsort,
    która sortuje malejąco według elementów
  • funkcję ksort,
    która sortuje rosnąco według kluczy
  • funkcję krsort,
    która sortuje malejąco według kluczy
  • funkcję asort,
    która sortuje rosnąco według elementów z zachowaniem kluczy
  • funkcję arsort,
    która sortuje malejąco według elementów z zachowaniem kluczy
  • funkcję natsort,
    która sortuje w sposób naturalny
  • funkcję natcasesort,
    która sortuje w sposób naturalny bez uwzględniania wielkości liter
  • funkcję usort,
    która sortuje według funkcji zwrotnej
  • funkcję uksort,
    która sortuje według funkcji zwrotnej po kluczach
  • funkcję uasort,
    która sortuje według funkcji zwrotnej z zachowaniem kluczy