(PHP 4, PHP 5, PHP 7, PHP 8)
strncmp — Comparação de strings segura para binários dos primeiros n caracteres
Esta função é parecida com strcmp(), com a diferença que pode-se especificar o (limite máximo do) número de caracteres de cada string que serão usados na comparação.
Observe que esta comparação é sensível a maiúsculas/minúsculas.
string1
A primeira string.
string2
A segunda string.
length
Número de caracteres a usar na comparação.
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.
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.
|
Exemplo #1 Exemplo de strncmp()
<?php
$var1 = 'Olá, João';
$var2 = 'Olá, Pedro';
if (strncmp($var1, $var2, 3) === 0) {
echo 'Primeiros 3 caracteres de $var1 e $var2 são iguais em uma comparação de strings sensível a maiúsculas/minúsculas.';
}
?>