strncasecmp

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

strncasecmp — Compare en binaire des chaînes de caractères

Description

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

strncasecmp() est similaire à strcasecmp(), à la différence près qu'elle permet de limiter le nombre de caractères utilisés pour comparer string1 et string2, avec le paramètre length.

Liste de paramètres

string1: La première chaîne.
string2: La seconde chaîne.
length: La longueur des chaînes à utiliser dans la comparaison.

Valeurs de retour

Retourne une valeur inférieure à 0 si string1 est inférieure à string2 ; une valeur supérieure à 0 si string1 est supérieure à string2, et 0 si elles sont égales. Aucune signification particulière ne peut être déduite de cette valeur, hormis son signe.

Historique

Version	Description
8.2.0	Cette fonction ne garantit plus de retourner `strlen($string1) - strlen($string2)` lorsque les longueurs des chaînes ne sont pas égales, et peut désormais retourner `-1` ou `1` à la place.

Exemples

Exemple #1 Exemple avec strncasecmp()

<?php
 
$var1 = 'Hello John';
$var2 = 'hello Doe';
if (strncasecmp($var1, $var2, 5) === 0) {
    echo 'Les 5 premiers caractères de $var1 et $var2 sont égaux dans une comparaison de chaînes de caractères insensibles à la casse.';
}
?>

Voir aussi

strncmp() - Comparaison binaire des n premiers caractères
preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard
substr_compare() - Compare deux chaînes depuis un offset jusqu'à une longueur en caractères
strcasecmp() - Comparaison insensible à la casse de chaînes binaires
stristr() - Version insensible à la casse de strstr
substr() - Retourne un segment de chaîne