# strstr

(PHP 4, PHP 5, PHP 7, PHP 8)

strstr — 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