sort
(PHP 4, PHP 5)
sort — Ordena un array
Descripción
&$array
[, int $sort_flags = SORT_REGULAR
] )Esta función ordena un array. Los elementos estarán ordenados de menor a mayor cuando la función haya terminado.
Parámetros
-
array -
El array de entrada.
-
sort_flags -
El segundo parámetro opcional
sort_flagspuede ser usado para modificar el modo de ordenación usando estos valores:Tipos de ordenación:
-
SORT_REGULAR- compara elementos normalmente (no cambia los tipos) -
SORT_NUMERIC- compara elementos de forma numérica -
SORT_STRING- compara elementos como cadenas -
SORT_LOCALE_STRING- compara elementos como cadenas, basándose en la configuración regional en uso. Utiliza la configuración regional, la cual puede cambiarse usando setlocale(). -
SORT_NATURAL- compara elementos como cadenas usando el "orden natural" de la misma forma que natsort(). -
SORT_FLAG_CASE- se puede combinar (OR a nivel de bits) conSORT_STRINGoSORT_NATURALpara ordenar cadenas de forma insensible a mayúsculas/minúsculas.
-
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ñadió el soporte para SORT_NATURAL y
SORT_FLAG_CASE como sort_flags
|
| 5.0.2 |
Se añadió SORT_LOCALE_STRING
|
Ejemplos
Ejemplo #1 Ejemplo de sort()
<?php
$frutas = array("limón", "naranja", "banana", "albaricoque");
sort($frutas);
foreach ($frutas as $clave => $valor) {
echo "frutas[" . $clave . "] = " . $valor . "\n";
}
?>
El resultado del ejemplo sería:
frutas[0] = albaricoque frutas[1] = banana frutas[2] = limón frutas[3] = naranja
Las frutas han sido ordenadas en orden alfabético.
Ejemplo #2 Ejemplo de sort() usando la ordenación insensible a mayúsculas/minúsculas natural
<?php
$frutas = array(
"Naranja1", "naranja2", "Naranja3", "naranja20"
);
sort($frutas, SORT_NATURAL | SORT_FLAG_CASE);
foreach ($frutas as $clave => $valor) {
echo "frutas[" . $clave . "] = " . $valor . "\n";
}
?>
El resultado del ejemplo sería:
frutas[0] = Naranja1 frutas[1] = naranja2 frutas[2] = Naranja3 frutas[3] = naranja20
Las frutas han sido ordenadas de la misma forma que natcasesort().
Notas
Nota: Esta función asigna nuevas clave a los elemenos del
array. Eliminará cualquier clave existenteque haya sido asignada, en lugar de reordenar las claves.
Nota: Como la mayoría de funciones de ordenación de PHP, sort() utiliza una implementación de » Quicksort.
Se ha de tener cuidado cuando se ordenen arrays con valores de tipos mixtos ya que sort() puede producir resultados impredecibles.
Ver también
- asort() - Ordena un array y mantiene la asociación de índices
- comparación de funciones de orden de arrays
