Az array_multisort függvény

Az array_multisort függvény lehetővé teszi több tömb egyidejű rendezését vagy összetett rendezést végez többdimenziós tömbökön egy vagy több kritérium alapján.

Szintaxis

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

A sorting_order paraméter

A sorting_order paraméter határozza meg a rendezés irányát. Itt vannak az értékei:

Paraméter Leírás
SORT_ASC Növekvő rendezés (alapértelmezett érték).
SORT_DESC Csökkenő rendezés.

A sorting_type paraméter

A sorting_type paraméter határozza meg az elemek összehasonlításának típusát. Itt vannak az értékei:

Paraméter Leírás
SORT_REGULAR Szabályos elemösszehasonlítás (alapértelmezés szerint).
SORT_NUMERIC Numerikus elemösszehasonlítás.
SORT_STRING Karakterlánc (string) elemösszehasonlítás.
SORT_LOCALE_STRING Karakterlánc összehasonlítás az aktuális locale beállítás figyelembevételével.
SORT_NATURAL Természetes (natural) karakterlánc rendezés (mint a fájlkezelőben).
SORT_FLAG_CASE Kombinálható a SORT_STRING vagy SORT_NATURAL értékekkel kis- és nagybetűt nem figyelembe vevő rendezéshez.

Példa

Két tömb rendezése paraméterek megadásával:

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

A kód végrehajtásának eredménye:

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

Példa

Többdimenziós tömb rendezése egy adott mező alapján:

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

A kód végrehajtásának eredménye:

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

Példa

Többdimenziós tömb rendezése két adott mező alapján:

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

A kód végrehajtásának eredménye:

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

Példa

Természetes (natural) karakterlánc rendezés:

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

A kód végrehajtásának eredménye:

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

Példa

Kis- és nagybetűt nem megkülönböztető rendezés:

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

A kód végrehajtásának eredménye:

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

Lásd még

  • a sort függvényt,
    amely növekvő sorrendbe rendezi az elemeket
  • a rsort függvényt,
    amely csökkenő sorrendbe rendezi az elemeket
  • a ksort függvényt,
    amely növekvő sorrendbe rendezi a kulcsokat
  • a krsort függvényt,
    amely csökkenő sorrendbe rendezi a kulcsokat
  • a asort függvényt,
    amely növekvő sorrendbe rendezi az elemeket a kulcsok megtartásával
  • a arsort függvényt,
    amely csökkenő sorrendbe rendezi az elemeket a kulcsok megtartásával
  • a natsort függvényt,
    amely természetes (natural) módon rendez
  • a natcasesort függvényt,
    amely természetes módon rendez kis- és nagybetűk megkülönböztetése nélkül
  • a usort függvényt,
    amely egy callback függvény alapján rendez
  • a uksort függvényt,
    amely egy callback függvény alapján rendezi a kulcsokat
  • a uasort függvényt,
    amely egy callback függvény alapján rendez a kulcsok megtartásával