stristr

(PHP 4, PHP 5)

stristr — Version insensible à la casse de strstr()

Description

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

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 à chercher.
needle: Si needle n'est pas une chaîne, elle sera convertie en entier, et utilisée comme code ASCII du caractère correspondant.
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`.
4.3.0	stristr() s'effectue en respectant les chaînes binaires.

Exemples

Exemple #1 Exemple avec stristr()

<?php
  $email = 'USER@EXAMPLE.com';
  echo stristr($email, 'e'); // Affiche ER@EXAMPLE.com
  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($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() - Expression rationnelle standard

stripslashes

Fonctions sur les chaînes de caractères

strlen

Manuel PHP