Funciones de Arrays
PHP Manual

array_multisort

(PHP 4, PHP 5)

array_multisortOrdena múltiples arrays, o arrays multi-dimensionales

Descripción

bool array_multisort ( array &$arr [, mixed $arg = SORT_ASC [, mixed $arg = SORT_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.

Parámetros

arr

Un valor tipo array a ordenar.

arg

Opcionalmente otro valor array, u opciones de ordenamiente para el argumento tipo matriz previo: SORT_ASC, SORT_DESC, SORT_REGULAR, SORT_NUMERIC, SORT_STRING.

...

args adicionales.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ordenar varios arrays

<?php
$matriz1 
= array(101001000);
$matriz2 = array(1324);
array_multisort($matriz1$matriz2);

var_dump($matriz1);
var_dump($matriz2);
?>

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.

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 multi-dimensional

<?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);
?>

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(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 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:

volumen| edicion
-------+--------
    67 |       2
    86 |       1
    85 |       6
    98 |       2
    86 |       6
    67 |       7

Los datos como un array, llamada datos. Ésta se obtendría usualmente, por ejemplo, mediante un ciclo con mysql_fetch_assoc().

<?php
$datos
[] = array('volumen' => 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.

<?php
// Obtener una lista de columnas
foreach ($data as $key => $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($volumeSORT_DESC$editionSORT_ASC$data);
?>

El conjunto de datos está ordenado ahora, y lucirá de este modo:

volumen| edicion
-------+--------
    98 |       2
    86 |       1
    86 |       6
    85 |       6
    67 |       2
    67 |       7

Ejemplo #4 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.

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

array_multisort($array_lowercaseSORT_ASCSORT_STRING$array);

print_r($array);
?>

El resultado del ejemplo sería:

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

Ver también


Funciones de Arrays
PHP Manual