strncmp

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

strncmpComparaison binaire des n premiers caractères

Description

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

Identique à la fonction strcmp(), avec la différence que vous pouvez spécifier le nombre maximum de caractères à utiliser pour la comparaison de string1 avec string2 grâce au paramètre length.

Notez que cette comparaison est sensible à la casse.

Liste de paramètres

string1

La première chaîne.

string2

La seconde chaîne.

length

Nombre de caractères à utiliser pour 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 strncmp()

<?php

$var1
= 'Hello John';
$var2 = 'Hello Doe';
if (
strncmp($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 sensibles à la casse.';
}
?>

Voir aussi

  • strncasecmp() - Compare en binaire des chaînes de 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
  • strcmp() - Comparaison binaire de chaînes
  • strstr() - Trouve la première occurrence dans une chaîne
  • substr() - Retourne un segment de chaîne