Funkcija array_multisort

Funkcija array_multisort leidžia vienu metu rūšiuoti kelis masyvus arba atlikti sudėtingą daugiamačių masyvų rūšiavimą pagal vieną ar kelis kriterijus.

Sintaksė

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

Parametras sorting_order

Parametras sorting_order nustato rūšiavimo kryptį. Štai jo reikšmės:

Parametras Aprašas
SORT_ASC Rūšiavimas didėjimo tvarka (numatytoji reikšmė).
SORT_DESC Rūšiavimas mažėjimo tvarka.

Parametras sorting_type

Parametras sorting_type nustato elementų palyginimo tipą. Štai jo reikšmės:

Parametras Aprašas
SORT_REGULAR Įprastinis elementų palyginimas (pagal nutylėjimą).
SORT_NUMERIC Skaitinis elementų palyginimas.
SORT_STRING Eilučių elementų palyginimas.
SORT_LOCALE_STRING Eilučių palyginimas atsižvelgiant į dabartinę lokalę.
SORT_NATURAL Natūralus eilučių rūšiavimas (kaip naršyklėje).
SORT_FLAG_CASE Kombinuojamas su SORT_STRING arba SORT_NATURAL registro nepaisančiam rūšiavimui.

Pavyzdys

Dviejų masyvų rūšiavimas nurodant parametrus:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Daugiamačio masyvo rūšiavimas pagal nurodytą lauką:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Daugiamačio masyvo rūšiavimas pagal du nurodytus laukus:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Natūralus eilučių rūšiavimas:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Registro nepaisantis rūšiavimas:

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

Kodo vykdymo rezultatas:

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

Taip pat žiūrėkite

  • funkciją sort,
    kuri rūšiuoja pagal elementų didėjimą
  • funkciją rsort,
    kuri rūšiuoja pagal elementų mažėjimą
  • funkciją ksort,
    kuri rūšiuoja pagal raktų didėjimą
  • funkciją krsort,
    kuri rūšiuoja pagal raktų mažėjimą
  • funkciją asort,
    kuri rūšiuoja pagal elementų didėjimą išsaugant raktus
  • funkciją arsort,
    kuri rūšiuoja pagal elementų mažėjimą išsaugant raktus
  • funkciją natsort,
    kuri rūšiuoja natūraliu būdu
  • funkciją natcasesort,
    kuri rūšiuoja natūraliu būdu neatsižvelgiant į registrą
  • funkciją usort,
    kuri rūšiuoja pagal callback funkciją
  • funkciją uksort,
    kuri rūšiuoja pagal callback funkciją pagal raktus
  • funkciją uasort,
    kuri rūšiuoja pagal callback funkciją išsaugant raktus