Comparação binária segura de strings

# strcmp

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

strcmp — Comparação binária segura de strings

### Descrição

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open