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

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