strncasecmp

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

strncasecmpComparação binária de strings, insensível a maiúsculas/minúsculas, dos primeiros n caracteres

Descrição

strncasecmp(string $string1, string $string2, int $length): int

Esta função é similar a strcasecmp(), com a diferença que pode ser especificado o número (limite superior) de caracteres de cada string usada na comparação.

Parâmetros

string1

A primeira string.

string2

A segunda string.

length

O tamanho das strings, que será usado na comparação.

Valor Retornado

Retorna -1 se string1 representa menos que string2; 1 se string1 representa mais que string2, e 0 se são iguais.

Registro de Alterações

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

Exemplos

Example #1 Exemplo de strncasecmp()

<?php

$var1 = 'Hello John';
$var2 = 'hello Doe';
if (strncasecmp($var1, $var2, 5) === 0) {
    echo 'Primeiros 5 caracteres de $var1 e $var2 são iguais em uma comparação insensível a maiúsculas/minúsculas';
}
?>

Veja Também

  • strncmp() - Comparação de strings segura para binários dos primeiros n caracteres
  • preg_match() - Realiza uma correspondência com expressão regular
  • substr_compare() - Comparação binária de duas strings a partir de uma posição até n caracteres
  • strcasecmp() - Comparação binária segura de strings insensível a maiúsculas/minúsculas
  • stristr() - strstr insensível a maiúsculas/minúsculas
  • substr() - Retorna parte de uma string