関数 array_multisort

関数 array_multisort は、複数の配列を同時にソートしたり、 1つまたは複数の基準で多次元配列の複雑なソートを行ったりすることができます。

構文

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

パラメータ sorting_order

パラメータ sorting_order は ソートの方向を指定します。以下の値があります:

パラメータ 説明
SORT_ASC 昇順ソート(デフォルト値)。
SORT_DESC 降順ソート。

パラメータ sorting_type

パラメータ sorting_type は 要素の比較タイプを指定します。以下の値があります:

パラメータ 説明
SORT_REGULAR 通常の要素比較(デフォルト)。
SORT_NUMERIC 数値として要素を比較。
SORT_STRING 文字列として要素を比較。
SORT_LOCALE_STRING 現在のロケールを考慮した文字列比較。
SORT_NATURAL 文字列の自然順ソート(エクスプローラーと同じ)。
SORT_FLAG_CASE SORT_STRING または SORT_NATURAL と組み合わせて、大文字小文字を区別しないソートを実行。

例

パラメータを指定して2つの配列をソート:

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

コード実行結果:

php[15, 10, 4, 2]
['d', 'b', 'c', '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);
?>

コード実行結果:

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

例

2つの指定フィールドで多次元配列をソート:

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

コード実行結果:

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

例

文字列の自然順ソート:

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

コード実行結果:

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

例

大文字小文字を区別しないソート:

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

コード実行結果:

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

関連項目

  • 関数 sort,
    要素を昇順でソート
  • 関数 rsort,
    要素を降順でソート
  • 関数 ksort,
    キーを昇順でソート
  • 関数 krsort,
    キーを降順でソート
  • 関数 asort,
    キーを保持して要素を昇順でソート
  • 関数 arsort,
    キーを保持して要素を降順でソート
  • 関数 natsort,
    自然順でソート
  • 関数 natcasesort,
    大文字小文字を区別せず自然順でソート
  • 関数 usort,
    コールバック関数でソート
  • 関数 uksort,
    コールバック関数でキーをソート
  • 関数 uasort,
    キーを保持してコールバック関数でソート