strncmp

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

strncmp — Comparació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

Devuelve un valor inferior a 0 si string1 es inferior a string2; un valor superior a 0 si string1 es superior a string2, y 0 si son iguales. No se puede deducir ningún significado particular de este valor, excepto su signo.

Historial de cambios

Versión	Descripción
8.2.0	Esta función ya no garantiza retornar `strlen($string1) - strlen($string2)` cuando las longitudes de las strings no son iguales, y puede retornar `-1` o `1` en su lugar.

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