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 case-insensitive (não diferencia letras maiúsculas de minúsculas) da natsort().

    Essa função implementa o algoritmo de ordenação que ordena 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ãoDescrição
    8.2.0 O tipo do retorno agora é true; anteriormente, era bool.

    Exemplos

    Exemplo #1 Exemplo da natcasesort()

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

    sort($array1);
    echo     "Standard sorting\n";
    print_r($array1);

    natcasesort($array2);
    echo     "\nNatural order sorting (case-insensitive)\n";
    print_r($array2);
    ?>

    O exemplo acima produzirá:

    Standard sorting Array ( [0] => IMG0.png [1] => IMG3.png [2] => img1.png [3] => img10.png [4] => img12.png [5] => img2.png ) Natural order sorting (case-insensitive) Array ( [0] => IMG0.png [4] => img1.png [3] => img2.png [5] => IMG3.png [2] => img10.png [1] => img12.png )

    Para mais informação veja: Martin Pool's » Natural Order String Comparison page.

    Veja Também

    To Top