Functie array_multisort

De functie array_multisort maakt het mogelijk om meerdere arrays tegelijkertijd te sorteren of complexe sortering van multidimensionale arrays uit te voeren volgens één of meerdere criteria.

Syntaxis

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

Parameter sorting_order

De parameter sorting_order bepaalt de sorteerrichting. Dit zijn zijn waarden:

Parameter Beschrijving
SORT_ASC Sorteren in oplopende volgorde (standaardwaarde).
SORT_DESC Sorteren in aflopende volgorde.

Parameter sorting_type

De parameter sorting_type bepaalt het type vergelijking van elementen. Dit zijn zijn waarden:

Parameter Beschrijving
SORT_REGULAR Standaard vergelijking van elementen (standaard).
SORT_NUMERIC Numerieke vergelijking van elementen.
SORT_STRING String vergelijking van elementen.
SORT_LOCALE_STRING String vergelijking met respect voor de huidige locale.
SORT_NATURAL Natuurlijke sortering van strings (zoals in verkenner).
SORT_FLAG_CASE Gecombineerd met SORT_STRING of SORT_NATURAL voor hoofdletterongevoelige sortering.

Voorbeeld

Sorteren van twee arrays met opgave van parameters:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Sorteren van een multidimensionale array op een opgegeven veld:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Sorteren van een multidimensionale array op twee opgegeven velden:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Natuurlijke sortering van strings:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Hoofdletterongevoelige sortering:

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

Resultaat van de code-uitvoering:

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

Zie ook

  • functie sort,
    die sorteert op oplopende elementen
  • functie rsort,
    die sorteert op aflopende elementen
  • functie ksort,
    die sorteert op oplopende sleutels
  • functie krsort,
    die sorteert op aflopende sleutels
  • functie asort,
    die sorteert op oplopende elementen met behoud van sleutels
  • functie arsort,
    die sorteert op aflopende elementen met behoud van sleutels
  • functie natsort,
    die sorteert op natuurlijke wijze
  • functie natcasesort,
    die sorteert op natuurlijke wijze zonder hoofdlettergevoeligheid
  • functie usort,
    die sorteert volgens een callback
  • functie uksort,
    die sorteert volgens een callback op sleutels
  • functie uasort,
    die sorteert volgens een callback met behoud van sleutels