(PHP 5 >= 5.2.0, PHP 7, PHP 8)
mb_stristr — Trouve la première occurrence d'une chaîne dans une autre, sans tenir compte de la casse
$haystack,$needle,$before_needle = false,$encoding = null
mb_stristr() trouve la première occurrence de
needle dans haystack
et retourne la portion de haystack.
Contrairement à mb_strstr(),
mb_stristr() est insensible à la casse.
Si needle n'est pas trouvé, la fonction retournera false.
haystack
La chaîne depuis laquelle on récupère la première occurrence de
needle
needle
La chaîne à chercher dans haystack
before_needle
Détermine quelle portion de haystack
cette fonction retourne.
Si défini à true, la fonction retournera toute la chaîne haystack
depuis le début jusqu'à la première occurrence de needle
(needle exclus).
Si défini à false, la fonction retournera toute la chaîne haystack
depuis la première occurrence de needle jusqu'à la fin
(needle inclus).
encodingLe paramètre encoding
est l'encodage des caractères. S'il est omis ou null, l'encodage de caractères interne
sera utilisé.
Retourne la portion de haystack,
ou false si needle n'est pas trouvé.
À partir de PHP 8.0.0, une ValueError est levée si
encoding est un encodage invalide.
Avant PHP 8.0.0, un E_WARNING était émis à la place.
| Version | Description |
|---|---|
| 8.0.0 |
needle accepte désormais une chaîne vide.
|
| 8.0.0 |
encoding est désormais nullable.
|
| 8.0.0 |
Lève désormais une ValueError si
encoding est un encodage invalide.
Auparavant, un E_WARNING était émis
et false était retourné.
|
Be aware that if needle is an empty string, mb_stristr return the haystack by default.
For exemple:
<?php
if (mb_stristr("foo", "")) {
echo "We enter in condition";
}
?>
Because in the above exemple the return of mb_stristr is "foo".
So if we do not want this kind of behaviour, we must set the third argument, ($before_needle) to true.
<?php
if (mb_stristr("foo", "", true)) {
echo "We do not enter in condition";
}
?>
It can be useful to know it, specially when needle is dynamic.