(PHP 4, PHP 5, PHP 7, PHP 8)
natsort — Ordena um array utilizando o algoritmo de "ordem natural"
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:
Nota:
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.
Nota:
Redefine o ponteiro interno do array para o primeiro elemento.
arrayO array de entrada.
Sempre retorna true.
| Versão | Descrição |
|---|---|
| 8.2.0 |
O tipo do retorno agora é true; anteriormente, era bool.
|
Exemplo #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.
Exemplo #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
)