Fungsi array_multisort

Fungsi array_multisort membolehkan penyusunan beberapa array serentak atau melakukan penyusunan kompleks array multidimensi mengikut satu atau beberapa kriteria.

Sintaks

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

Parameter sorting_order

Parameter sorting_order menetapkan arah penyusunan. Berikut adalah nilainya:

Parameter Keterangan
SORT_ASC Susunan menaik (nilai lalai).
SORT_DESC Susunan menurun.

Parameter sorting_type

Parameter sorting_type menetapkan jenis perbandingan elemen. Berikut adalah nilainya:

Parameter Keterangan
SORT_REGULAR Perbandingan elemen biasa (lalai).
SORT_NUMERIC Perbandingan elemen berangka.
SORT_STRING Perbandingan elemen rentetan.
SORT_LOCALE_STRING Perbandingan rentetan dengan mengambil kira lokal semasa.
SORT_NATURAL Susunan rentetan semula jadi (seperti dalam penjelajah fail).
SORT_FLAG_CASE Digabungkan dengan SORT_STRING atau SORT_NATURAL untuk penyusunan tidak sensitif huruf.

Contoh

Menyusun dua array dengan menetapkan parameter:

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

Hasil pelaksanaan kod:

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

Contoh

Menyusun array multidimensi mengikut medan yang ditentukan:

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

Hasil pelaksanaan kod:

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

Contoh

Menyusun array multidimensi mengikut dua medan yang ditentukan:

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

Hasil pelaksanaan kod:

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

Contoh

Susunan rentetan semula jadi:

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

Hasil pelaksanaan kod:

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

Contoh

Susunan tidak sensitif huruf:

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

Hasil pelaksanaan kod:

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

Lihat juga

  • fungsi sort,
    yang menyusun mengikut kenaikan elemen
  • fungsi rsort,
    yang menyusun mengikut penurunan elemen
  • fungsi ksort,
    yang menyusun mengikut kenaikan kunci
  • fungsi krsort,
    yang menyusun mengikut penurunan kunci
  • fungsi asort,
    yang menyusun mengikut kenaikan elemen dengan pemeliharaan kunci
  • fungsi arsort,
    yang menyusun mengikut penurunan elemen dengan pemeliharaan kunci
  • fungsi natsort,
    yang menyusun secara semula jadi
  • fungsi natcasesort,
    yang menyusun secara semula jadi tanpa kes sensitif huruf
  • fungsi usort,
    yang menyusun mengikut callback
  • fungsi uksort,
    yang menyusun mengikut callback untuk kunci
  • fungsi uasort,
    yang menyusun mengikut callback dengan pemeliharaan kunci