strncmp

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

strncmpComparación binaria de los n primeros caracteres

Descripción

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

Idéntica a la función strcmp(), con la diferencia de que se puede especificar el número máximo de caracteres a utilizar para la comparación de string1 con string2 mediante el parámetro length.

Tenga en cuenta que esta comparación es sensible a mayúsculas y minúsculas.

Parámetros

string1

El primer string.

string2

El segundo string.

length

Número de caracteres a utilizar para la comparación.

Valores devueltos

Returns a value less than 0 if string1 is less than string2; a value greater than 0 if string1 is greater than string2, and 0 if they are equal. No particular meaning can be reliably inferred from the value aside from its sign.

Historial de cambios

Versión Descripción
8.2.0 This function is no longer guaranteed to return strlen($string1) - strlen($string2) when string lengths are not equal, but may now return -1 or 1 instead.

Ejemplos

Ejemplo #1 Ejemplo con strncmp()

<?php

$var1
= 'Hello John';
$var2 = 'Hello Doe';
if (
strncmp($var1, $var2, 5) === 0) {
echo
'Los 5 primeros caracteres de $var1 y $var2 son iguales en una comparación de strings sensibles a mayúsculas y minúsculas.';
}
?>

Ver también

  • strncasecmp() - Comparación binaria de strings insensible a mayúsculas/minúsculas
  • preg_match() - Realiza una búsqueda de coincidencia con una expresión regular estándar
  • substr_compare() - Comparar dos strings desde un offset hasta una longitud en caracteres
  • strcmp() - Comparación binaria de strings
  • strstr() - Encuentra la primera ocurrencia en un string
  • substr() - Devuelve un segmento de string