Trouve la première occurrence dans une chaîne

# strstr

(PHP 4, PHP 5, PHP 7)

strstr — Trouve la première occurrence dans une chaîne

### Description

strstr ( 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.

> Note:

> strstr() est sensible à la casse. Pour une fonctionnalité identique, mais insensible à la casse, reportez-vous à stristr().

> Note:

> Si vous voulez juste déterminer si un `needle` particulier se trouve dans la chaîne `haystack`, utilisez la fonction strpos() qui est plus rapide et qui consomme moins de ressources.

### Liste de paramètres

`haystack`

  La chaîne d'entrée.

`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`, strstr() retourne la partie de `haystack` avant la première occurrence de `needle` (`needle` étant exclus).

### Valeurs de retour

Retourne la portion de la chaîne, ou `FALSE` si `needle` n'est pas trouvé.

### Historique

Version | Description
--- | ---
5.3.0 | Ajout du paramètre optionnel `before_needle`.
4.3.0 | strstr() est maintenant compatible avec les données binaires.

### Exemples

Exemple #1 Exemple avec strstr()

`<?php
$email = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // Affiche : @example.com
$user = strstr($email, '@', true); // Depuis PHP 5.3.0
echo $user; // Affiche : name
?>`

### Voir aussi

- stristr() - Version insensible à la casse de strstr
- strrchr() - Trouve la dernière occurrence d'un caractère dans une chaîne
- strpos() - Cherche la position de la première occurrence dans une chaîne
- 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