natcasesort

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

    natcasesort — Ordena 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

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicionar nota

    Notas de Usuários 1 note

    up
    46
    dslicer at maine dot rr dot com
    22 years ago
    Something that should probably be documented is the fact that both natsort and natcasesort maintain the key-value associations of the array. If you natsort a numerically indexed array, a for loop will not produce the sorted order; a foreach loop, however, will produce the sorted order, but the indices won't be in numeric order. If you want natsort and natcasesort to break the key-value associations, just use array_values on the sorted array, like so:

natcasesort($arr);
$arr = array_values($arr);
    ＋adicionar nota
    To Top