stristr

(PHP 4, PHP 5, PHP 7)

stristrVersion insensible à la casse de strstr()

Description

stristr ( string $haystack , mixed $needle [, bool $before_needle = FALSE ] ) : string

Retourne une sous-chaîne de haystack, allant de la première occurrence de needle (incluse) jusqu'à la fin de la chaîne.

Liste de paramètres

haystack

La chaîne dans laquelle on doit chercher.

needle

Si needle n'est pas une chaîne de charactères, elle est convertie en un entier et appliqué en tant que valeur ordinal d'un charactè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 charactè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

Version Description
5.3.0 Ajout du paramètre optionnel before_needle.

Exemples

Exemple #1 Exemple avec stristr()

<?php
  $email 
'[email protected]';
  echo 
stristr($email'e'); // Affiche [email protected]
  
echo stristr($email'e'true); // Depuis PHP 5.3.0, 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($string112); // 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