strncmp

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

strncmpBinary safe string comparison of the first n characters

Descrição

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

This function is similar to strcmp(), with the difference that you can specify the (upper limit of the) number of characters from each string to be used in the comparison.

Note that this comparison is case sensitive.

Parâmetros

string1

The first string.

string2

The second string.

length

Number of characters to use in the comparison.

Valor Retornado

Returns -1 if string1 is less than string2; 1 if string1 is greater than string2, and 0 if they are equal.

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 strncmp() example

<?php

$var1
= 'Hello John';
$var2 = 'Hello Doe';
if (
strncmp($var1, $var2, 5) === 0) {
echo
'First 5 characters of $var1 and $var2 are equals in a case-sensitive string comparison';
}
?>

Veja Também

  • strncasecmp() - Comparação binária de strings, insensível a maiúsculas/minúsculas, dos primeiros n caracteres
  • preg_match() - Perform a regular expression match
  • substr_compare() - Comparação binária de duas strings a partir de uma posição até n caracteres
  • strcmp() - Binary safe string comparison
  • strstr() - Find the first occurrence of a string
  • substr() - Retorna parte de uma string
To Top