strnatcasecmp

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

    strnatcasecmp — Comparação de strings insensível a maiúsculas/minúsculas usando o algoritmo de "ordem natural"

    Descrição

    strnatcasecmp(string$string1, string$string2): int

    Esta função implementa um algoritmo de comparação que ordena strings alfanuméricos da maneira que um ser humano faria. O comportamento desta função é similar a strnatcmp(), exceto que a comparação não é sensível a maiúsculas/minúsculas. Para maiores informações consulte: » Comparação de Strings em Ordem Natural, de Martin Pool.

    Parâmetros

    string1

    A primeira string.

    string2

    A segunda string.

    Valor Retornado

    Similar a outras funções de comparação de strings, esta retorna -1 se string1 representar menos que string21 se string1 representar mais que string2, e 0 se forem iguais.

    Registro de Alterações

    VersãoDescrição
    8.2.0 Esta função agora retorna -1 ou 1, onde anteriormente retornava um número negativo ou positivo.

    Exemplos

    Exemplo #1 Exemplo de strnatcasecmp()

    <?php

    var_dump    (strnatcasecmp('Apple', 'Banana'));
    var_dump(strnatcasecmp('Banana', 'Apple'));
    var_dump(strnatcasecmp('apple', 'Apple'));
    ?>

    O exemplo acima produzirá:

    int(-1) int(1) int(0)

    Veja Também

    • preg_match() - Perform a regular expression match
    • strcmp() - Binary safe string comparison
    • strcasecmp() - Binary safe case-insensitive string comparison
    • substr() - Retorna parte de uma string
    • stristr() - Case-insensitive strstr
    • strncasecmp() - Comparação binária de strings, insensível a maiúsculas/minúsculas, dos primeiros n caracteres
    • strncmp() - Binary safe string comparison of the first n characters
    • strstr() - Find the first occurrence of a string
    • setlocale() - Set locale information
    To Top