array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.natcasesort.php', 1 => 'natcasesort', 2 => 'Ordena um array utilizando o algoritmo de "ordem natural" sem diferenciar maiúsculas e minúsculas', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.list.php', 1 => 'list', ), 'next' => array ( 0 => 'function.natsort.php', 1 => 'natsort', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/natcasesort.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

natcasesort

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

natcasesort — Ordena um array utilizando o algoritmo de "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 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, consulte a página » Natural Order String Comparison de Martin Pool.

Veja Também