array_multisort
Ordena varios arrays, o arrays multidimensionales
&reftitle.description;
boolarray_multisort
arrayarray1
mixedarray1_sort_orderSORT_ASC
mixedarray1_sort_flagsSORT_REGULAR
mixed...
array_multisort puede usarse para ordenar varios
arrays al mismo tiempo, o un array multidimensional por una o más
dimensiones.
Las claves asociativas (string) se mantendrán, aunque las
claves numéricas serán reindexadas.
¬e.sort-unstable;
&reftitle.parameters;
array1
Un array a ordenar.
array1_sort_order
El orden usado para ordenar el argumento anterior array. Puede ser
SORT_ASC para orden ascendente o SORT_DESC
para orden descendente.
Este argumento se puede intercambiar con array1_sort_flags
u omitir por completo, en cuyo caso se asume SORT_ASC.
array1_sort_flags
Opciones de ordenación para el argumento previo array:
Banderas de tipo de ordenación:
SORT_REGULAR - compara los elementos normalmente
(no cambia los tipos)
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 regional en uso. Utiliza la configuración regional,
la cual se puede cambiar usando setlocale
SORT_NATURAL - compara los elementos como strings
usando un "orden natural" como natsort
SORT_FLAG_CASE - puede ser combinado
(OR a nivel de bits) con
SORT_STRING o
SORT_NATURAL para ordenar strings sin considerar mayúsculas/minúsculas
Este argumento puede ser intercambiado con array1_sort_order
u omitido por completo, en cuyo caso se asume SORT_REGULAR.
...
Más arrays, opcionalmente seguidos de una opción de ordenación y banderas. Solamente se
comparan los elementos correspondientes a elementos equivalentes en arrays previos.
En otras palabras, el orden el lexicográfico.
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&Version;
&Description;
5.4.0
Se añadieron SORT_NATURAL y SORT_FLAG_CASE
a array1_sort_flags como posibles banderas de ordenación.
5.3.0
Se añadió SORT_LOCALE_STRING a
array1_sort_flags como posible bandera de ordenación.
&reftitle.examples;
Ordenar varios arrays
]]>
En este ejemplo, después de la ordenación, el primer array contendrá
los valores 0, 10, 100, 100. El segundo array contendrá 4, 1, 2, 3.
Las entradas en el segundo array correspondientes a las entradas
idénticas del primer array (100 y 100) fueron ordenadas también.
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)
}
]]>
Ordenar un array multidimensional
]]>
En este ejemplo, después de la ordenación, el primer array se
transformará en "10", 100, 100, 11, "a" (fue ordenado como string en
orden ascendente). El segundo contendrá 1, 3, "2", 2, 1 (ordenada como
números, en orden descendiente).
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)
}
}
]]>
Ordenar resultados de una base de datos
Para este ejemplo, cada elemento del array datos
representa una fila de una tabla. Este tipo de conjunto de datos es
típico de los registros en una base de datos.
Datos de ejemplo:
Los datos como un array, llamados datos. Éste se
obtendría normalmente, por ejemplo, mediante un bucle con mysqli_fetch_assoc.
67, 'edición' => 2);
$datos[] = array('volumen' => 86, 'edición' => 1);
$datos[] = array('volumen' => 85, 'edición' => 6);
$datos[] = array('volumen' => 98, 'edición' => 2);
$datos[] = array('volumen' => 86, 'edición' => 6);
$datos[] = array('volumen' => 67, 'edición' => 7);
?>
]]>
En este ejemplo, ordenaremos por volumen descendientemente,
y por edición ascendentemente.
Tenemos un array de filas, pero array_multisort
requiere un array de columnas, así que usamos el código siguiente para obtener
las columnas, y luego realizar la ordenación.
$fila) {
$volumen[$clave] = $fila['volumen'];
$edición[$clave] = $fila['edición'];
}
// a partir de PHP 5.5.0 puede usar array_column() en lugar del código anterior
$volume = array_column($data, 'volume');
$edition = array_column($data, 'edition');
// Ordenar los datos con volumen descendiente, edición ascendiente
// Agregar $datos como el último parámetro, para ordenar por la clave común
array_multisort($volumen, SORT_DESC, $edición, SORT_ASC, $datos);
?>
]]>
El conjunto de datos ahora está ordenado, y será de este modo:
Ordenación sin considerar mayúsculas/minúsculas
Tanto SORT_STRING como
SORT_REGULAR consideran las mayúsculas/minúsculas,
los string que comiencen con una letra mayúscula irán antes que
los string que comiencen con una letra minúscula.
Para realizar una ordenación sin considerar mayúsculas y minúsculas, asegúrese
de que el orden sea determinado por una copia en minúsculas del array original.
]]>
&example.outputs;
Alpha
[1] => atomic
[2] => bank
[3] => Beta
)
]]>
&reftitle.seealso;
usort
&seealso.array.sorting;