(PHP 4, PHP 5, PHP 7, PHP 8)
array_multisort — Ordena los arrays multidimensionales
&$array1
,$array1_sort_order
= SORT_ASC,$array1_sort_flags
= SORT_REGULAR,...$rest
array_multisort() se utiliza para ordenar simultáneamente varios arrays, o bien para ordenar un array multidimensional, según una u otra de sus dimensiones.
Las claves asociativas (string) serán mantenidas, pero las claves numéricas serán reindexadas.
Nota:
Si dos miembros se comparan como iguales, ellos mantendrán su orden original. Antes de PHP 8.0.0, su orden relativo en un array ordenado era indefinido.
Nota:
Reinicia el puntero interno del array al primer elemento.
array1
Un array a ordenar.
array1_sort_order
El orden utilizado para ordenar el argumento anterior
array. O bien la constante SORT_ASC
para ordenar de forma ascendente, o bien la constante
SORT_DESC
para ordenar de forma descendente.
Este argumento puede ser asociado con el parámetro
array1_sort_flags
o simplemente omitido,
en cuyo caso, la constante SORT_ASC
será utilizada.
array1_sort_flags
Opciones de ordenación del argumento anterior array :
Tipo de opciones de ordenación :
SORT_REGULAR
- compara los elementos normalmente (sin cambio de tipo)
SORT_NUMERIC
- compara los elementos numéricamente
SORT_STRING
- compara los elementos como strings
SORT_LOCALE_STRING
- compara los elementos como strings,
basándose en la configuración local actual. La función utiliza las configuraciones locales, y pueden ser modificadas
utilizando la función setlocale()
SORT_NATURAL
- compara los elementos como strings, utilizando
el "orden natural", como hace la función natsort()
SORT_FLAG_CASE
- puede ser combinado (con el operador OR) con
SORT_STRING
o
SORT_NATURAL
para ordenar las strings sin tener en cuenta las mayúsculas y minúsculas
Este argumento puede ser asociado con el parámetro array1_sort_order
o simplemente omitido, en cuyo caso, la constante SORT_REGULAR
será utilizada.
rest
Más argumentos, opcionalmente seguidos por formas de ordenar y flags. Solo los elementos equivalentes en los arrays anteriores son comparados. En otras palabras, la ordenación es lexicográfica.
Ejemplo #1 Ordenar varios arrays
<?php
$ar1 = array(10, 100, 100, 0);
$ar2 = array(1, 3, 2, 4);
array_multisort($ar1, $ar2);
var_dump($ar1);
var_dump($ar2);
?>
En este ejemplo, después de la ordenación, el primer array contiene 0, 10, 100, 100. El segundo array contiene 4, 1, 2, 3. Las entradas del segundo array correspondientes a los valores duplicados del primer array (100 y 100), también son ordenadas.
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) }
Ejemplo #2 Ordenar un array multidimensional
<?php
$ar = array(
array("10", 11, 100, 100, "a"),
array( 1, 2, "2", 3, 1)
);
array_multisort($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
var_dump($ar);
?>
En este ejemplo, después de la ordenación, el primer array contiene "10", 100, 100, 11, "a" (orden alfabético, orden ascendente); El segundo array contiene 1, 3, "2", 2, 1 (orden numérico, orden descendente).
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) } }
Ejemplo #3 Ordenar los resultados de una base de datos
En este ejemplo, cada elemento del array data representa una fila de la tabla. Este tipo de datos es típico de un registro de base de datos.
Ejemplo de datos :
volume | edition -------+-------- 67 | 2 86 | 1 85 | 6 98 | 2 86 | 6 67 | 7
Los datos están en forma de array, llamado data. Esto es generalmente el resultado, por ejemplo, de la función mysqli_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);
?>
En este ejemplo, se ordenará la columna volume en orden descendente, y la columna edition en orden ascendente.
Se tiene un array de filas, pero array_multisort() requiere un array de columnas, por lo que se utiliza el siguiente código para obtener las columnas y así realizar la ordenación.
<?php
// Obtiene una lista de columnas
foreach ($data as $key => $row) {
$volume[$key] = $row['volume'];
$edition[$key] = $row['edition'];
}
// puede utilizar array_column() en lugar del código anterior
$volume = array_column($data, 'volume');
$edition = array_column($data, 'edition');
// Ordena los datos por volume descendente, edition ascendente
// Añade $data como último parámetro, para ordenar por la clave común
array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
?>
El conjunto de registros está ahora ordenado y se ve así :
volume | edition -------+-------- 98 | 2 86 | 1 86 | 6 85 | 6 67 | 2 67 | 7
Ejemplo #4 Ordenación no sensible a mayúsculas y minúsculas
SORT_STRING
y
SORT_REGULAR
son sensibles a mayúsculas y minúsculas, las strings
que comienzan con una letra mayúscula vendrán antes que las strings
que comienzan con una letra minúscula.
Para realizar una ordenación no sensible a mayúsculas y minúsculas, realice la ordenación sobre una copia en minúsculas de las columnas del array original.
<?php
$array = array('Alpha', 'atomic', 'Beta', 'bank');
$array_lowercase = array_map('strtolower', $array);
array_multisort($array_lowercase, SORT_ASC, SORT_STRING, $array);
print_r($array);
?>
El resultado del ejemplo sería:
Array ( [0] => Alpha [1] => atomic [2] => bank [3] => Beta )