Version insensible à la casse de strstr

# stristr

(PHP 4, PHP 5, PHP 7)

stristr — Version 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 ce fier à celui-ci est fortement déconseillée. En fonction du comportement attendu, `needle` doit être transtyper explicitement en une chaîne de charactère, ou faire 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`.
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() - Effectue une recherche de correspondance avec une expression rationnelle standard