array_multisort

(PHP 4, PHP 5, PHP 7)

array_multisortСортирует несколько массивов или многомерные массивы

Описание

bool array_multisort ( array &$array1 [, mixed $array1_sort_order = SORT_ASC [, mixed $array1_sort_flags = SORT_REGULAR [, mixed $... ]]] )

Функция array_multisort() может быть использована для сортировки сразу нескольких массивов или одного многомерного массива в соответствии с одной или несколькими размерностями.

Ассоциативные (string) ключи будут сохранены, но числовые ключи будут переиндексированы.

Список параметров

array1

Сортируемый массив (array).

array1_sort_order

Порядок для сортировки вышеуказанного аргумента array. Или SORT_ASC для сортировки по возрастанию, или SORT_DESC для сортировки по убыванию.

Этот аргумент может меняться местами с array1_sort_flags или вообще быть пропущенным. В этом случае подразумевается значение SORT_ASC.

array1_sort_flags

Настройки сортировки для вышеуказанного аргумента array:

Флаг способа сортировки:

  • SORT_REGULAR - обычное сравнение элементов (без изменения типов)
  • SORT_NUMERIC - сравнение элементов как чисел
  • SORT_STRING - сравнение элементов как строк
  • SORT_LOCALE_STRING - сравнение элементов как строк, учитывая текущую локаль. Используется локаль, которую можно менять с помощью функции setlocale()
  • SORT_NATURAL - сравнение элементов как строк с использованием алгоритма "natural order", так же как в функции natsort()
  • SORT_FLAG_CASE - может быть объединен (бинарное OR) с SORT_STRING или SORT_NATURAL для сортировки без учета регистра

Этот аргумент может меняться местами с array1_sort_order или вообще быть пропущенным. В этом случае подразумевается значение SORT_REGULAR .

...

Дополнительные массивы, необязательно следующие после порядка сортировки и флагов.

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Список изменений

Версия Описание
5.4.0 Добавлены SORT_NATURAL и SORT_FLAG_CASE в возможные флаги сортировки array1_sort_flags.
5.3.0 Добавлен SORT_LOCALE_STRING в возможные флаги сортировки array1_sort_flags.

Примеры

Пример #1 Сортировка нескольких массивов

<?php
$ar1 
= array(101001000);
$ar2 = array(1324);
array_multisort($ar1$ar2);

var_dump($ar1);
var_dump($ar2);
?>

В вышеприведенном примере, после того, как будет осуществлена сортировка, первый массив будет содержать 0, 10, 100, 100. Второй - 4, 1, 2, 3. Элементы второго массива, соответствующие идентичным элементам первого (100 и 100), также будут отсортированы.

array(4) {
  [0]=> int(0)
  [1]=> int(10)
  [2]=> int(100)
  [3]=> int(100)
}
array(4) {
  [0]=> int(4)
  [1]=> int(1)
  [2]=> int(2)
  [3]=> int(3)
}

Пример #2 Сортировка многомерного массива

<?php
$ar 
= array(
       array(
"10"11100100"a"),
       array(   
1,  2"2",   3,   1)
      );
array_multisort($ar[0], SORT_ASCSORT_STRING,
                
$ar[1], SORT_NUMERICSORT_DESC);
var_dump($ar);
?>

В вышеприведенном примере, после сортировки, первый массив будет содержать "10", 100, 100, 11, "a" (его элементы были отсортированы в возрастающем порядке), а второй массив будет содержать 1, 3, "2", 2, 1 (элементы отсортированы как числа, в порядке убывания).

array(2) {
  [0]=> array(5) {
    [0]=> string(2) "10"
    [1]=> int(100)
    [2]=> int(100)
    [3]=> int(11)
    [4]=> string(1) "a"
  }
  [1]=> array(5) {
    [0]=> int(1)
    [1]=> int(3)
    [2]=> string(1) "2"
    [3]=> int(2)
    [4]=> int(1)
  }
}

Пример #3 Сортировка результатов из базы данных

В этом примере, каждый элемент массива data представляет собой ряд таблицы. Такой тип данных типичен для записей базы данных.

Примерные данные:

# том  | издание
volume | edition
-------+--------
    67 |       2
    86 |       1
    85 |       6
    98 |       2
    86 |       6
    67 |       7

Данные представлены в виде массива с именем data. Обычно их можно получить, к пример, с помощью цикла из функции mysql_fetch_assoc().

<?php
$data
[] = array('volume' => 67'edition' => 2);
$data[] = array('volume' => 86'edition' => 1);
$data[] = array('volume' => 85'edition' => 6);
$data[] = array('volume' => 98'edition' => 2);
$data[] = array('volume' => 86'edition' => 6);
$data[] = array('volume' => 67'edition' => 7);
?>

В нашем примере мы будем сортировать по volume в убывающем порядке, а по edition - в возрастающем.

У нас есть массив строк, но array_multisort() необходим массив столбцов, поэтому сначала мы используем следующий код для получения столбцов, а потом выполним сортировку.

<?php
// Получение списка столбцов
foreach ($data as $key => $row) {
    
$volume[$key]  = $row['volume'];
    
$edition[$key] = $row['edition'];
}

// Сортируем данные по volume по убыванию и по edition по возрастанию
// Добавляем $data в качестве последнего параметра, для сортировки по общему ключу
array_multisort($volumeSORT_DESC$editionSORT_ASC$data);
?>

Теперь данные отсортированы и будут выглядеть вот так:

volume | edition
-------+--------
    98 |       2
    86 |       1
    86 |       6
    85 |       6
    67 |       2
    67 |       7

Пример #4 Сортировка без учета регистра

Обе константы SORT_STRING и SORT_REGULAR учитывают регистр при сортировке, строки, начинающиеся с заглавной буквы будут выставлены раньше строк, начинающихся со строчной буквы.

Для выполнения безрегистрового поиска нужно заставить выполнить порядок сортировки по копии оригинального массива, переведенного в нижний регистр.

<?php
$array 
= array('Alpha''atomic''Beta''bank');
$array_lowercase array_map('strtolower'$array);

array_multisort($array_lowercaseSORT_ASCSORT_STRING$array);

print_r($array);
?>

Результат выполнения данного примера:

Array
(
    [0] => Alpha
    [1] => atomic
    [2] => bank
    [3] => Beta
)

Смотрите также

Коментарии

Often, one may have a group of arrays which have parallel data that need to be kept associated with each other (e.g., the various attribute values of a group of elements might be stored in their own arrays). Using array_multisort as is, by specifying additional fields, it is possible, as in the documentation example cited below, that this association will be lost. 

To take this example set of data from the documentation:
<?php
$ar1 
= array("10"100100"a");
$ar2 = array(13"2"1);
?>

The example goes on to sort it this way:
<?php
array_multisort
($ar1$ar2);
?>

In this case, although the "10" remains associated with the first '1' after being sorted, the "2" and '3' are reversed from their original order.

In order to sort by one field only (yet still have the other array(s) being correspondingly sorted), one can use array_keys (which makes an array out of the keys) to ensure that no further sub-sorting is performed. This works because array_keys is making an array for which no duplicates can exist (since keys will be unique), and thus, the subsequent fields will have no relevance as far as subsorting.

So, using the above data, we can perform this sort instead:
<?php
$ar3 
array_keys($ar1);
array_multisort($ar1$ar3$ar2);
?>

which, when $ar1 and $ar2 are dumped gives:

array(4) {
  [0]=> string(2) "10"
  [1]=> string(1) "a"
  [2]=> int(100)
  [3]=> int(100)
}
array(4) {
  [0]=>  int(1)
  [1]=>  int(1)
  [2]=>  int(3)
  [3]=>  string(1) "2"
}
2006-09-14 03:04:21
http://php5.kiev.ua/manual/ru/function.array-multisort.html
A more inuitive way of sorting multidimensional arrays using array_msort() in just one line, you don't have to divide the original array into per-column-arrays:

<?php

$arr1 
= array(
    array(
'id'=>1,'name'=>'aA','cat'=>'cc'),
    array(
'id'=>2,'name'=>'aa','cat'=>'dd'),
    array(
'id'=>3,'name'=>'bb','cat'=>'cc'),
    array(
'id'=>4,'name'=>'bb','cat'=>'dd')
);

$arr2 array_msort($arr1, array('name'=>SORT_DESC'cat'=>SORT_ASC));

debug($arr1$arr2);

arr1:
   
0:
       
id(int)
       
nameaA (string:2)
       
catcc (string:2)
   
1:
       
id(int)
       
nameaa (string:2)
       
catdd (string:2)
   
2:
       
id(int)
       
namebb (string:2)
       
catcc (string:2)
   
3:
       
id(int)
       
namebb (string:2)
       
catdd (string:2)
arr2:
   
2:
       
id(int)
       
namebb (string:2)
       
catcc (string:2)
   
3:
       
id(int)
       
namebb (string:2)
       
catdd (string:2)
   
0:
       
id(int)
       
nameaA (string:2)
       
catcc (string:2)
   
1:
       
id(int)
       
nameaa (string:2)
       
catdd (string:2)

function 
array_msort($array$cols)
{
   
$colarr = array();
    foreach (
$cols as $col => $order) {
       
$colarr[$col] = array();
        foreach (
$array as $k => $row) { $colarr[$col]['_'.$k] = strtolower($row[$col]); }
    }
   
$eval 'array_multisort(';
    foreach (
$cols as $col => $order) {
       
$eval .= '$colarr[\''.$col.'\'],'.$order.',';
    }
   
$eval substr($eval,0,-1).');';
    eval(
$eval);
   
$ret = array();
    foreach (
$colarr as $col => $arr) {
        foreach (
$arr as $k => $v) {
           
$k substr($k,1);
            if (!isset(
$ret[$k])) $ret[$k] = $array[$k];
           
$ret[$k][$col] = $array[$k][$col];
        }
    }
    return 
$ret;

}

?>
2009-06-20 15:16:54
http://php5.kiev.ua/manual/ru/function.array-multisort.html
I came up with an easy way to sort database-style results. This does what example 3 does, except it takes care of creating those intermediate arrays for you before passing control on to array_multisort(). 

<?php
function array_orderby()
{
   
$args func_get_args();
   
$data array_shift($args);
    foreach (
$args as $n => $field) {
        if (
is_string($field)) {
           
$tmp = array();
            foreach (
$data as $key => $row)
               
$tmp[$key] = $row[$field];
           
$args[$n] = $tmp;
            }
    }
   
$args[] = &$data;
   
call_user_func_array('array_multisort'$args);
    return 
array_pop($args);
}
?>

The sorted array is now in the return value of the function instead of being passed by reference.

<?php
$data
[] = array('volume' => 67'edition' => 2);
$data[] = array('volume' => 86'edition' => 1);
$data[] = array('volume' => 85'edition' => 6);
$data[] = array('volume' => 98'edition' => 2);
$data[] = array('volume' => 86'edition' => 6);
$data[] = array('volume' => 67'edition' => 7);

// Pass the array, followed by the column names and sort flags
$sorted array_orderby($data'volume'SORT_DESC'edition'SORT_ASC);
?>
2010-10-21 17:26:26
http://php5.kiev.ua/manual/ru/function.array-multisort.html
USort function can be used to sort multidimensional arrays with almost no work whatsoever by using the individual values within the custom sort function.

This function passes the entire child element even if it is not a string. If it is an array, as would be the case in multidimensional arrays, it will pass the whole child array as one parameter.

Therefore, do something elegant like this:

<?php
     
// Sort the multidimensional array
     
usort($results"custom_sort");
     
// Define the custom sort function
     
function custom_sort($a,$b) {
          return 
$a['some_sub_var']>$b['some_sub_var'];
     }
?>

This does in 4 lines what other functions took 40 to 50 lines to do. This does not require you to create temporary arrays or anything. This is, for me, a highly preferred solution over this function.

Hope it helps!
2011-09-15 18:36:20
http://php5.kiev.ua/manual/ru/function.array-multisort.html
Автор:
When sorting an array of (complex) objects, this function can give you a "Fatal error:  Nesting level too deep" since it directly compares elements in later arrays if the elements in earlier ones compare equal. This can be worked around with the Flag-Parameter:
<?php 
$sortKeys 
array_map($extractKey$lotsOfComplexObjects);
array_multisort($sortKeys$lotsOfComplexObjectsSORT_ASCSORT_NUMERIC);
?>
I'm replacing an 'uasort()'-call which is significantly slower since it leads to a lot of calls to the comparison-function but most of the objects involved are recursive.

If this 'trick' gives a wrong order,  you need a better key.
2013-10-11 18:25:00
http://php5.kiev.ua/manual/ru/function.array-multisort.html
Автор:
Hi,

I would like to see the next code snippet to be added to http://nl3.php.net/array_multisort

Purpose: Sort a 2-dimensional array on some key(s)

Advantage of function: 
- uses PHP's array_multisort function for sorting;
- it prepares the arrays (needed by array_multisort) for you;
- allows the sort criteria be passed as a separate array (It is possible to use sort order and flags.); 
- easy to set/overwrite the way strings are sorted (case insensitive instead of case sensitive, which is PHP's default way of sorting);
- performs excellent 

function MultiSort($data, $sortCriteria, $caseInSensitive = true)
{
  if( !is_array($data) || !is_array($sortCriteria))
    return false;       
  $args = array(); 
  $i = 0;
  foreach($sortCriteria as $sortColumn => $sortAttributes) 
  {
    $colList = array(); 
    foreach ($data as $key => $row)
    { 
      $convertToLower = $caseInSensitive && (in_array(SORT_STRING, $sortAttributes) || in_array(SORT_REGULAR, $sortAttributes)); 
      $rowData = $convertToLower ? strtolower($row[$sortColumn]) : $row[$sortColumn]; 
      $colLists[$sortColumn][$key] = $rowData;
    }
    $args[] = &$colLists[$sortColumn];
     
    foreach($sortAttributes as $sortAttribute)
    {     
      $tmp[$i] = $sortAttribute;
      $args[] = &$tmp[$i];
      $i++;     
     }
  }
  $args[] = &$data;
  call_user_func_array('array_multisort', $args);
  return end($args);


Usage:

//Fill an array with random test data
define('MAX_ITEMS', 15);
define('MAX_VAL', 20);
for($i=0; $i < MAX_ITEMS; $i++)
  $data[] = array('field1' => rand(1, MAX_VAL), 'field2' => rand(1, MAX_VAL), 'field3' => rand(1, MAX_VAL) );
 
//Set the sort criteria (add as many fields as you want)
$sortCriteria = 
  array('field1' => array(SORT_DESC, SORT_NUMERIC), 
       'field3' => array(SORT_DESC, SORT_NUMERIC)
  );

//Call it like this: 
$sortedData = MultiSort($data, $sortCriteria, true);
2014-01-09 14:11:07
http://php5.kiev.ua/manual/ru/function.array-multisort.html
One-liner function to sort multidimensionnal array by key, thank's to array_column

<?php

array_multisort 
(array_column($array'key'), SORT_DESC$array);

?>
2016-05-06 00:02:46
http://php5.kiev.ua/manual/ru/function.array-multisort.html

    Поддержать сайт на родительском проекте КГБ