Fonction substr_compare() de PHP

Exemple

Comparaison de deux chaînes de caractères :

<?php
echo substr_compare("Hello world","Hello world",0);
?>

Exemple de exécution

Définition et utilisation

substr_compare() compare deux chaînes de caractères à partir de la position de début spécifiée.

Astuce :La fonction est sécurisée pour les binaires et sensiblement sensible à la casse.

Syntaxe

substr_compare(string1,string2,startpos,length,case)
Paramètres Description
string1 Obligatoire. Détermine la première chaîne de caractères à comparer.
string2 Obligatoire. Détermine la deuxième chaîne de caractères à comparer.
startpos Obligatoire. Détermine où commencer la comparaison dans string1 si c'est un nombre négatif, il commence à compter à partir de la fin de la chaîne de caractères.
length Optionnel. Détermine où commencer la comparaison dans string1 de combien de caractères les caractères sont comparés (nombre de caractères).
case

Optionnel. Valeur booléenne, déterminant si la comparaison sensible à la casse doit être exécutée :

  • FALSE - Par défaut. Sensible à la casse
  • TRUE - Sensible à la casse

Détails techniques

Valeur de retour :

La fonction retourne :

  • 0 - Si les deux chaînes de caractères sont égales
  • <0 - Si string1 (à partir de la position de début startpos)inférieur string2
  • >0 - Si string1 (à partir de la position de début startpos)supérieur string2

Si length Supérieur ou égal string1 de la longueur, alors la fonction retourne FALSE.

Version PHP : 5+
Journal des mises à jour : Depuis PHP 5.1, il est permis d'utiliser des nombres négatifs startpos

Plus d'exemples

Exemple 1

Comparaison de deux chaînes, lorsque string1 Position de comparaison du début de la chaîne est 6 :

<?php
echo substr_compare("Hello world","world",6);
?>

Exemple de exécution

Exemple 2

Utiliser tous les paramètres :

<?php
echo substr_compare("world","or",1,2);
echo substr_compare("world","ld",-2,2);
echo substr_compare("world","orl",1,2);
echo substr_compare("world","OR",1,2,TRUE);
echo substr_compare("world","or",1,3);
echo substr_compare("world","rl",1,2);
?>

Exemple de exécution

Exemple 3

Différents résultats de retour :

<?php
echo substr_compare("Hello world!","Hello world!",0); // Les deux chaînes sont égales
echo substr_compare("Hello world!","Hello",0); // string1 supérieur string2
echo substr_compare("Hello world!","Hello world! Hello!",0); // string1 inférieur string2
?>

Exemple de exécution