strstr

(PHP 4, PHP 5)

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

Description

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

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, elle sera convertie en entier, et utilisée comme code ASCII du caractère correspondant.
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() - Expression rationnelle standard

strspn

Fonctions sur les chaînes de caractères

strtok

Manuel PHP