sort

(PHP 4, PHP 5)

sort — Ordena um array

Descrição

bool sort ( array &$array [, int $sort_flags ] )

Essa função ordena um array. Os elementos serão ordenados do menor para o maior ao final da execução dessa função.

Parâmetros

array

O array de entrada.

sort_flags

O segundo parâmetro opcional sort_flags pode ser usado para modificar o comportamento da ordenação usando estes valores:

Flags para tipo de ordenação:

  • SORT_REGULAR - compara os itens normalmente (não modifica o tipo)
  • SORT_NUMERIC - compara os items numericamente
  • SORT_STRING - compara os itens como strings
  • SORT_LOCALE_STRING - compara os itens como strings, baseado no locale atual. Adicionado no PHP 4.4.0 e PHP 5.0.2. Antes do PHP 6, usava local do sistema, que pode ser alterado usando setlocale(). Já no PHP 6, você precisa usar a função i18n_loc_set_default().

Valor Retornado

Retorna TRUE em caso de sucesso ou FALSE em caso de falha.

Changelog

Versão Descrição
4.0.0 O parâmetro sort_flags foi adicionado.

Exemplos

Example #1 Exemplo da sort()

<?php

$frutas = array("limao", "laranja", "banana", "melancia");
sort($frutas);
foreach ($fruits as $key => $val) {
    echo "frutas[".$chave."] = ".$valor."\n";
}
 
?>

O exemplo acima irá imprimir:

fruits[0] = banana
fruits[1] = laranja
fruits[2] = limao
fruits[3] = melancia

As frutas foram classificadas em ordem alfabética.

Notas

Note: Esta função define novas chaves para os elementos em array. Ela irá remover qualquer chave que você tenha definido, ao invés de simplesmente reordenar as chaves.

Note: Como muitas funções de ordenação do PHP, sort() usa uma implementação da » Quicksort.

Warning

Tenha cuidado quando ordenando arrays com vários tipos de valores, porque sort() pode produzir um resultado indesejado.

Veja Também

  • arsort() - Ordena um array em ordem descrescente mantendo a associação entre índices e valores
  • asort() - Ordena um array mantendo a associação entre índices e valores
  • ksort() - Ordena um array pelas chaves
  • rsort() - Ordena um array em ordem descrescente
  • usort() - Ordena um array pelos valores utilizando uma função de comparação definida pelo usuário
  • uksort() - Ordena um array pelas chaves utilizando uma função de comparação definida pelo usuário.
  • array_multisort() - Ordena múltiplos arrays ou arrays multidimensionais
  • krsort() - Ordena um array pelas chaves em ordem descrescente
  • natsort() - Ordena um array utilizando o algoritmo da "ordem natural"
  • natcasesort() - Ordena um array utilizando o algoritmo da "ordem natural" sem diferenciar maiúsculas e minúsculas