array_multisort
Ordena múltiples arrays, o arrays multi-dimensionales
&reftitle.description;
boolarray_multisort
arrayarr
mixedargSORT_ASC
mixedargSORT_REGULAR
mixed...
array_multisort puede usarse para ordenar varios
arrays al mismo tiempo, o un array multi-dimensional por una o más
dimensiones.
Las llaves asociativas (string) se mantendrán, aunque las
llaves numéricas son re-indexadas.
&reftitle.parameters;
arr
Un valor tipo array a ordenar.
arg
Opcionalmente otro array, u opciones de ordenación para el
argumento array anterior:
Banderas de tipo de ordenación:
SORT_ASC - ordena los elementos ascendentemente.
SORT_DESC - ordena los elementos descendentemente.
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 el "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 tener en cuent las mayúsculas/minúsculas
...
args adicionales.
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&Version;
&Description;
5.4.0
Se añadieron SORT_NATURAL y SORT_FLAG_CASE
a arg como posibles banderas de ordenación.
5.3.0
Se añadió SORT_LOCALE_STRING a
arg como posible bandera de ordenación.
&reftitle.examples;
Ordenar varios arrays
]]>
En este ejemplo, después del ordenado, el primer array contendrá
los valores 0, 10, 100, 100. El segundo array contendrá 4, 1, 2, 3.
Las entradas en el segundo array que correspondían 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 multi-dimensional
]]>
En este ejemplo, después del ordenado, el primer array se
transformará a 10, 100, 100, 11, "a" (fue ordenada como cadenas en
orden ascendente), y la segunda tendrá 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 en el array datos
representa una fila en 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, llamada datos. Ésta se
obtendría usualmente, por ejemplo, mediante un ciclo con mysql_fetch_assoc.
67, 'edicion' => 2);
$datos[] = array('volumen' => 86, 'edicion' => 1);
$datos[] = array('volumen' => 85, 'edicion' => 6);
$datos[] = array('volumen' => 98, 'edicion' => 2);
$datos[] = array('volumen' => 86, 'edicion' => 6);
$datos[] = array('volumen' => 67, 'edicion' => 7);
?>
]]>
En este ejemplo, ordenaremos por volumen
descendientemente, y por edicion ascendentemente.
Tenemos un array de filas, pero array_multisort
requiere un array de columnas, así que usamos el código a continuación para obtener
las columnas, y luego realizar el ordenado.
$row) {
$volume[$key] = $row['volume'];
$edition[$key] = $row['edition'];
}
// Ordenar los datos con volumen descendiente, edicion ascendiente
// Agregar $datos como el último parámetro, para ordenar por la llave común
array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
?>
]]>
El conjunto de datos está ordenado ahora, y lucirá de este modo:
Ordenardo insensible a mayúsculas/minúsculas
Tanto SORT_STRING como
SORT_REGULAR son sensibles a
mayúsculas/minúsculas, las cadenas que comienzan con una letra
mayúscula vendrán antes que las cadenas con una letra minúscula.
Para realizar una búsqueda insensible a minúsculas y mayú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;