Funkcia array_multisort

Funkcia array_multisort umožňuje triediť viacero polí súčasne alebo vykonávať zložité triedenie viacrozmerných polí podľa jedného alebo viacerých kritérií.

Syntax

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

Parameter sorting_order

Parameter sorting_order nastavuje smer triedenia. Tu sú jeho hodnoty:

Parameter Popis
SORT_ASC Triedenie vo vzostupnom poradí (predvolená hodnota).
SORT_DESC Triedenie v zostupnom poradí.

Parameter sorting_type

Parameter sorting_type nastavuje typ porovnania prvkov. Tu sú jeho hodnoty:

Parameter Popis
SORT_REGULAR Bežné porovnanie prvkov (predvolené).
SORT_NUMERIC Číselné porovnanie prvkov.
SORT_STRING Reťazcové porovnanie prvkov.
SORT_LOCALE_STRING Reťazcové porovnanie s ohľadom na aktuálnu lokalitu.
SORT_NATURAL Prirodzené triedenie reťazcov (ako v priezkumníkovi).
SORT_FLAG_CASE Kombinuje sa s SORT_STRING alebo SORT_NATURAL pre triedenie bez ohľadu na veľkosť písmen.

Príklad

Triedenie dvoch polí so zadaním parametrov:

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

Výsledok vykonania kódu:

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

Príklad

Triedenie viacrozmerného poľa podľa zadaného poľa:

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

Výsledok vykonania kódu:

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

Príklad

Triedenie viacrozmerného poľa podľa dvoch zadaných polí:

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

Výsledok vykonania kódu:

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

Príklad

Prirodzené triedenie reťazcov:

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

Výsledok vykonania kódu:

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

Príklad

Triedenie bez ohľadu na veľkosť písmen:

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

Výsledok vykonania kódu:

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

Pozrite tiež

  • funkciu sort,
    ktorá triedi vo vzostupnom poradí prvkov
  • funkciu rsort,
    ktorá triedi v zostupnom poradí prvkov
  • funkciu ksort,
    ktorá triedi vo vzostupnom poradí kľúčov
  • funkciu krsort,
    ktorá triedi v zostupnom poradí kľúčov
  • funkciu asort,
    ktorá triedi vo vzostupnom poradí prvkov so zachovaním kľúčov
  • funkciu arsort,
    ktorá triedi v zostupnom poradí prvkov so zachovaním kľúčov
  • funkciu natsort,
    ktorá triedi prirodzeným spôsobom
  • funkciu natcasesort,
    ktorá triedi prirodzeným spôsobom bez ohľadu na veľkosť písmen
  • funkciu usort,
    ktorá triedi podľa spätného volania
  • funkciu uksort,
    ktorá triedi podľa spätného volania podľa kľúčov
  • funkciu uasort,
    ktorá triedi podľa spätného volania so zachovaním kľúčov