PHP substr_compare() Fonction

❮ Référence de chaîne PHP

Exemple

Comparer deux chaînes :

<?php
echo substr_compare("Hello world","Hello world",0);
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction substr_compare() compare deux chaînes à partir d'une position de départ spécifiée.

Astuce : Cette fonction est sécurisée pour les binaires et peut être sensible à la casse.


Syntaxe

substr_compare( string1,string2,startpos,length,case )

Valeurs des Paramètres

Paramètre Description
string1 Requis. Spécifie la première chaîne à comparer.
string2 Requis. Spécifie la deuxième chaîne à comparer.
startpos Requis. Indique où commencer la comparaison dans string1. Si négatif, il commence à compter à partir de la fin de la chaîne.
length Optionnel. Indique combien de caractères de string1 comparer.
case Optionnel. Une valeur booléenne qui spécifie s'il faut ou non effectuer une comparaison sensible à la casse :
  • FALSE - Par défaut. Sensible à la casse.
  • TRUE - Insensible à la casse.


Détails Techniques

Valeur de Retour : Cette fonction retourne :
  • 0 - si les deux chaînes sont égales.
  • <0 - si string1 (à partir de startpos) est inférieure à string2.
  • >0 - si string1 (à partir de startpos) est supérieure à string2.
Si length est égal ou supérieur à la longueur de string1, cette fonction retourne FALSE.
Version PHP : 5+

Plus d'Exemples

Exemple

Comparer deux chaînes lorsque la position de départ dans string1 pour la comparaison est la 6ème :

<?php
echo substr_compare("Hello world","world",6);
?>
Essayez-le vous-même »

Exemple

Utilisation de 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);
?>
Essayez-le vous-même »

Exemple

Valeurs de retour différentes :

<?php
echo substr_compare("Hello world!","Hello world!",0); // les deux chaînes sont égales
echo substr_compare("Hello world!","Hello",0); // string1 est supérieure à string2
echo substr_compare("Hello world!","Hello world! Hello!",0); // string1 est inférieure à string2
?>
Essayez-le vous-même »

❮ Référence de chaîne PHP