array_multisort
Ordena los arrays multidimensionales
&reftitle.description;
truearray_multisort
arrayarray1
mixedarray1_sort_orderSORT_ASC
mixedarray1_sort_flagsSORT_REGULAR
mixedrest
array_multisort sirve para ordenar simultáneamente
varios arrays, o bien para ordenar un array multidimensional,
siguiendo una u otra de sus dimensiones.
Las claves asociativas (&string;) serán mantenidas, pero
las claves numéricas serán reindexadas.
¬e.sort-unstable;
¬e.reset-index;
&reftitle.parameters;
array1
Un &array; a ordenar.
array1_sort_order
El orden utilizado para ordenar el argumento anterior
array. Puede ser la constante SORT_ASC
para ordenar de forma ascendente, o 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 array anterior:
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 locales, y estas pueden ser modificadas
utilizando la función setlocale
SORT_NATURAL - compara los elementos como strings, utilizando
el "orden natural", como lo hace la función natsort
SORT_FLAG_CASE - puede ser combinado (con el operador OR) con
SORT_STRING o
SORT_NATURAL para ordenar los strings sin tener en cuenta la casilla
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, el ordenamiento es lexicográfico.
&reftitle.returnvalues;
&return.true.always;
&reftitle.changelog;
&Version;
&Description;
8.5.0
El tipo de retorno es ahora &true;; anteriormente, era bool.
&reftitle.examples;
Ordenar varios arrays
]]>
En este ejemplo, después del ordenamiento, 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.
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 del ordenamiento, 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(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 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:
Los datos están en forma de array, llamado data.
Esto es generalmente el resultado, por ejemplo, de la función
mysqli_fetch_assoc.
En este ejemplo, vamos a ordenar la columna
volume en orden descendente, y
la columna edition en orden ascendente.
Tenemos un array de filas, pero
array_multisort requiere un array de columnas,
por lo tanto utilizamos el siguiente código para obtener las columnas y
así realizar el ordenamiento.
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);
// Obtiene una lista de columnas
foreach ($data as $key => $row) {
$volume[$key] = $row['volume'];
$edition[$key] = $row['edition'];
}
// Puede utilizarse 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);
// Recorre los datos y muestra los valores ordenados para cada columna
echo 'volume | edition', PHP_EOL;
echo '-------+--------', PHP_EOL;
for ($i = 0; $i < count($data); $i++) {
printf("%6d | %7d\n", $volume[$i], $edition[$i]);
}
?>
]]>
El conjunto de registros ahora está ordenado y se ve así:
Ordenamiento no sensible a la casilla
SORT_STRING y
SORT_REGULAR son sensibles a la casilla, los strings
que comienzan con una letra mayúscula vendrán antes
que los strings que comienzan con una letra minúscula.
Para realizar un ordenamiento no sensible a la casilla, realice el ordenamiento
sobre una copia en minúsculas de las columnas del array original.
]]>
&example.outputs;
Alpha
[1] => atomic
[2] => bank
[3] => Beta
)
]]>
&reftitle.seealso;
usort
&seealso.array.sorting;