strncasecmp

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

strncasecmp — Comparación binaria de strings insensible a mayúsculas/minúsculas

Descripción

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

strncasecmp() es similar a strcasecmp(), con la diferencia de que permite limitar el número de caracteres utilizados para comparar string1 y string2, mediante el argumento length.

Parámetros

string1: El primer string.
string2: El segundo string.
length: La longitud de los strings a utilizar en 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 strncasecmp()

<?php

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

Ver también

strncmp() - Comparación binaria de los n primeros caracteres
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
strcasecmp() - Comparación insensible a mayúsculas/minúsculas de strings binarios
stristr() - Versión insensible a mayúsculas y minúsculas de strstr
substr() - Devuelve un segmento de string