# array_multisort

(PHP 4, PHP 5, PHP 7, PHP 8)

array_multisort — Ordena varios arrays, o arrays multidimensionales

### Descripción

array_multisort(
array `&$array1`,
mixed `$array1_sort_order` = SORT_ASC,
mixed `$array1_sort_flags` = SORT_REGULAR,
mixed `$...` = ?
): bool

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.

> Nota:

> Si dos miembros se comparan como iguales, su orden relativo en el array oredenado será indefinido.

### Parámetros

`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.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
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.

### Ejemplos

Ejemplo #1 Ordenar varios arrays

`<?php
$array1 = array(10, 100, 100, 0);
$array2 = array(1, 3, 2, 4);
array_multisort($array1, $array2);
var_dump($array1);
var_dump($array2);
?>`

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.

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

    volumen| edición
    -------+--------
        67 |       2
        86 |       1
        85 |       6
        98 |       2
        86 |       6
        67 |       7

Los datos como un array, llamados datos. Éste se obtendría normalmente, por ejemplo, mediante un bucle con mysqli_fetch_assoc().

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

`<?php
// Obtener una lista de columnas
foreach ($datos as $clave => $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:

    volumen| edición
    -------+--------
        98 |       2
        86 |       1
        86 |       6
        85 |       6
        67 |       2
        67 |       7

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

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

### Ver también

- usort() - Ordena un array según sus valores usando una función de comparación definida por el usuario
- comparación de funciones de orden de arrays