natcasesort

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

natcasesortOrdena um array utilizando o algoritmo da "ordem natural" sem diferenciar maiúsculas e minúsculas

Descrição

natcasesort(array &$array): true

natcasesort() é uma versão insensível a maiúsculas/minúsculas de natsort().

Essa função implementa o algoritmo de ordenação que classifica strings alfanuméricas da forma que os humanos fariam mantendo associação de chave/valor. Essa forma de ordenação é denominada "ordenação natural".

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.

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

Exemplo #1 Exemplo de natcasesort()

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

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

natcasesort($array2);
echo
"\nOrdenação natural (insensível a maiúsculas/minúsculas)\n";
print_r($array2);
?>

O exemplo acima produzirá:

Ordenação padrão
Array
(
    [0] => IMG0.png
    [1] => IMG3.png
    [2] => img1.png
    [3] => img10.png
    [4] => img12.png
    [5] => img2.png
)

Ordenação natural (insensível a maiúsculas/minúsculas)
Array
(
    [0] => IMG0.png
    [4] => img1.png
    [3] => img2.png
    [5] => IMG3.png
    [2] => img10.png
    [1] => img12.png
)

Para mais informação veja a página » Natural Order String Comparison de Martin Pool.

Veja Também