strcmp

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

strcmpComparação binária segura de strings

Descrição

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

Observe que esta comparação é sensível a maiúsculas/minúsculas. Para comparação insensível a maiúsculas/minúsculas, consulte strcasecmp().

Observe que esta comparação não considera a localidade. Para comparação que considera a localidade, consulte strcoll() ou Collator::compare().

Parâmetros

string1

A primeira string

string2

A segunda string

Valor Retornado

Retorna um valor menor que 0 se string1 for abaixo de string2; um valor maior que 0 se string1 for acima de string2 e 0 se elas forem iguais. Nenhum significado em particular pode ser inferido com confiança desse valor a não ser o seu sinal.

Registro de Alterações

Versão Descrição
8.2.0 Não é mais garantido que esta função retornará strlen($string1) - strlen($string2) quando os comprimentos das strings não forem iguais, mas ppodem agora retornar -1 ou 1 no lugar.

Exemplos

Exemplo #1 Exemplo de strcmp()

<?php
$var1
= "Olá";
$var2 = "olá";
if (
strcmp($var1, $var2) !== 0) {
echo
'$var1 não é igual a $var2 em uma comparação sensível a maiúsculas/minúsculas';
}
?>

Veja Também

  • Comparações de string completa
    • strcasecmp() - Comparação binária segura de strings insensível a maiúsculas/minúsculas
    • Collator::compare() - Compara duas strings Unicode
    • strcoll() - Comparação de strings baseada em localidade
  • Comparações de string parcial
    • substr_compare() - Comparação binária de duas strings a partir de uma posição até n caracteres
    • strncmp() - Comparação de strings segura para binários dos primeiros n caracteres
    • strstr() - Encontra a primeira ocorrência de uma string
  • Outras comparações de string / similares
    • preg_match() - Realiza uma correspondência com expressão regular
    • levenshtein() - Calcula a distância Levenshtein entre duas strings
    • metaphone() - Calcula a chave de Metaphone de uma string
    • similar_text() - Calcula a similaridade entre duas strings
    • soundex() - Calcula a chave soundex de uma string