(PHP 4, PHP 5, PHP 7, PHP 8)
stristr — Version insensible à la casse de strstr()
Description
stristr(string
$haystack
, string
$needle
, bool
$before_needle
=
false
): string|false
Liste de paramètres
-
haystack
-
La chaîne dans laquelle on doit chercher.
-
needle
-
La chaîne à rechercher.
Antérieur à PHP 8.0.0, si needle
n'est pas une chaîne de caractères,
elle est convertie en un entier et appliqué en tant que valeur ordinal d'un caractère.
Ce comportement est obsolète à partir de PHP 7.3.0, et se fier à celui-ci
est fortement déconseillé. En fonction du comportement attendu,
needle
doit être transtypé explicitement en une chaîne de caractère,
ou un appel explicite à chr() doit être exécuté.
-
before_needle
-
Si vaut true
, stristr()
retourne la partie de haystack
avant la première
occurrence de needle
(needle
exclus).
needle
et haystack
sont traitées sans tenir compte de la casse.
Valeurs de retour
Retourne la partie de la chaîne correspondante. Si
needle
n'est pas trouvé, la fonction
retourne false
.
Historique
Exemples
Exemple #1 Exemple avec stristr()
<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // Affiche ER@EXAMPLE.com
echo stristr($email, 'e', true); // Affiche US
?>
Exemple #2 Teste si une chaîne de caractères est trouvée ou pas
<?php
$string = 'Hello World!';
if(stristr($string, 'terre') === FALSE) {
echo '"terre" non trouvé dans la chaîne de caractères';
}
// affiche : "terre" non trouvé dans la chaîne de caractères
?>
Exemple #3 Utilisation d'une "chaîne de caractères" en chiffre
<?php
$string = 'POMME';
echo stristr($string, 112); // 112 = p minuscule
// Affiche : POMME
?>
Notes
Note:
Cette fonction gère les chaînes binaires.
Voir aussi
- strstr() - Trouve la première occurrence dans une chaîne
- strrchr() - Trouve la dernière occurrence d'un caractère dans une chaîne
- stripos() - Recherche la position de la première occurrence dans une chaîne, sans tenir compte de la casse
- strpbrk() - Recherche un ensemble de caractères dans une chaîne de caractères
- preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard