natsort

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

natsort — Ordena um array utilizando o algoritmo de "ordem natural"

Descrição

natsort(array &$array): true

Essa função implementa um algoritmo que ordena strings alfanuméricas da forma como um ser humano faria enquanto mantém associações de chave/valor. Isto é descrito como "ordenação natural". Um exemplo da diferença entre este algoritmo e o algoritmo de ordenação comum de strings (usado em sort()) pode ser visto no exemplo abaixo:

Note:

Se dois elementos são comparados como iguais, eles mantêm sua ordem original. Antes do PHP 8.0.0, sua ordem relativa no array ordenado era indefinida.

Note:

Redefine o ponteiro interno do array para o primeiro elemento.

Parâmetros

array

O array de entrada.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.2.0 O tipo do retorno agora é true; anteriormente, era bool.

Exemplos

Example #1 Exemplo de natsort() demonstrando seu uso básico

<?php
$array1 = $array2 = array("img12.png", "img10.png", "img2.png", "img1.png");

sort($array1);
echo "Classificação padrão\n";
print_r($array1);

natsort($array2);
echo "\nClassificação em ordem natural\n";
print_r($array2);
?>

O exemplo acima produzirá:

Classificação padrão
Array
(
    [3] => img1.png
    [1] => img10.png
    [0] => img12.png
    [2] => img2.png
)

Classificação em ordem natural
Array
(
    [3] => img1.png
    [2] => img2.png
    [1] => img10.png
    [0] => img12.png
)

Para mais informações, consulte a página » Comparação de Strings em Ordem Natural do autor Martin Pool.

Example #2 Exemplos de natsort() demonstrando potenciais ciladas

<?php
echo "Números negativos\n";
$negativos = array('-5','3','-2','0','-1000','9','1');
print_r($negativos);
natsort($negativos);
print_r($negativos);

echo "Zero à esquerda\n";
$zeros = array('09', '8', '10', '009', '011', '0');
print_r($zeros);
natsort($zeros);
print_r($zeros);
?>

O exemplo acima produzirá:

Números negativos
Array
(
    [0] => -5
    [1] => 3
    [2] => -2
    [3] => 0
    [4] => -1000
    [5] => 9
    [6] => 1
)
Array
(
    [2] => -2
    [0] => -5
    [4] => -1000
    [3] => 0
    [6] => 1
    [1] => 3
    [5] => 9
)

Zero à esquerda
Array
(
    [0] => 09
    [1] => 8
    [2] => 10
    [3] => 009
    [4] => 011
    [5] => 0
)
Array
(
    [5] => 0
    [1] => 8
    [3] => 009
    [0] => 09
    [2] => 10
    [4] => 011
)

Veja Também