Encuentra la primera aparición de un string

Descripción

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

Devuelve parte del string haystack iniciando desde e incluyendo la primera aparición de needle (aguja) hasta el final del haystack (pajar).

Nota:
Esta función es sensible a mayúsculas. Para búsquedas sin importar las mayúsculas, use stristr().

Nota:
Si solo se quiere saber si un needle determinado aparece en un haystack, se utiliza la función strpos() que es más rápida y requiere menos memoria.

Parámetros

haystack: El string en donde buscar.
needle: Si needle no es una cadena, se convierte a un entero y se aplica como el valor ordinal de un carácter. Este comportamiento está obsoleto a partir de PHP 7.3.0, por lo que su uso está totalmente desaconsejado. Dependiendo del comportamiento previsto, needle deberá ser convertido explícitamente a string, o realizar una llamada explícita a chr().
before_needle: Si se define como TRUE, strstr() devolverá la parte del haystack antes de la primera ocurrencia de needle (excluyendo el needle).

Valores devueltos

Devuelve una parte de un string o FALSE si no se encuentra el needle.

Historial de cambios

Versión	Descripción
5.3.0	Se añadió el parámetro opcional `before_needle`.
4.3.0	strstr() se hizo segura binariamente.

Ejemplos

Ejemplo #1 Ejemplo de strstr()


<?php
$email  = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // mostrará @example.com

$user = strstr($email, '@', true); // Desde PHP 5.3.0
echo $user; // mostrará name
?>

Ver también

stristr() - strstr insensible a mayúsculas y minúsculas
strrchr() - Encuentra la última aparición de un caracter en un string
strpos() - Encuentra la posición de la primera ocurrencia de un substring en un string
strpbrk() - Buscar una cadena por cualquiera de los elementos de un conjunto de caracteres
preg_match() - Realiza una comparación con una expresión regular