substr_compare
(PHP 5)
substr_compare — Compare deux chaînes depuis un offset jusqu'à une longueur en caractères
Description
$main_str
, string $str
, int $offset
[, int $length
[, bool $case_insensitivity = false
]] )
substr_compare() compare main_str
à partir de la position offset avec str
pendant length caractères.
Liste de paramètres
-
main_str -
La chaîne principale à comparer.
-
str -
La chaîne secondaire à comparer.
-
offset -
La position de départ de la comparaison. Si c'est une valeur négative, on commence à compter à partir de la fin de la chaîne.
-
length -
La longueur de la comparaison. La valeur par défaut est la plus grande longueur du paramètre
strcomparée à la longueur demain_str, moins la valeur du paramètreoffset. -
case_insensitivity -
Si
case_insensitivityvautTRUE, la comparaison est insensible à la casse.
Valeurs de retour
Retourne < 0 si main_str à partir de
offset est inférieur à str, >
0 s'il est plus grand que str, et 0 si ils sont égaux.
Si length est égal ou plus grand que la taille de
main_str ou que length est configuré
et est inférieur à 1, substr_compare() affiche une alerte et retourne FALSE.
Historique
| Version | Description |
|---|---|
| 5.1.0 |
Ajout de la possibilité d'utiliser une valeur négative pour le
paramètre offset.
|
Exemples
Exemple #1 Exemple avec substr_compare()
<?php echo substr_compare("abcde", "bc", 1, 2); // 0 echo substr_compare("abcde", "de", -2, 2); // 0 echo substr_compare("abcde", "bcg", 1, 2); // 0 echo substr_compare("abcde", "BC", 1, 2, true); // 0 echo substr_compare("abcde", "bc", 1, 3); // 1 echo substr_compare("abcde", "cd", 1, 2); // -1 echo substr_compare("abcde", "abc", 5, 1); // warning ?>
