Encuentra la primera ocurrencia en un string

# strstr

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

strstr — Encuentra la primera ocurrencia en un string

### Descripción

function strstr(string `$haystack`, string `$needle`, bool `$before_needle` = `false`): string|false

Devuelve una subcadena de `haystack`, desde la primera ocurrencia de `needle` (incluida) hasta el final del string.

> Nota:

> strstr() es sensible a mayúsculas y minúsculas. Para una funcionalidad idéntica, pero insensible a mayúsculas y minúsculas, consulte stristr().

> Nota:

> Si el objetivo es únicamente determinar si un cierto valor de `needle` se encuentra en `haystack`, la función str_contains() que es más rápida y menos exigente en memoria debería ser utilizada en su lugar.

### Parámetros

`haystack`

  El string de entrada.

`needle`

  El string a buscar.

  Anterior a PHP 8.0.0, si `needle` no es una cadena de caracteres, se convierte en un entero y se aplica como valor ordinal de un carácter. Este comportamiento está obsoleto a partir de PHP 7.3.0, y confiar en él está fuertemente desaconsejado. Dependiendo del comportamiento esperado, `needle` debe ser explícitamente convertido a una cadena de caracteres, o debe realizarse una llamada explícita a chr().
`before_needle`

  Si es `true`, strstr() devuelve la parte de `haystack` antes de la primera ocurrencia de `needle` (`needle` excluido).

### Valores devueltos

Devuelve la porción del string, o `false` si `needle` no es encontrado.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `needle` acepta ahora una cadena vacía.
8.0.0 | Pasar un int como `needle` ya no es soportado.
7.3.0 | Pasar un int como `before_needle` ha sido declarado obsoleto.

### Ejemplos

Ejemplo #1 Ejemplo con strstr()

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

    $user = strstr($email, '@', true);
    echo $user, PHP_EOL; // Muestra: name
    ?>

### Ver también

- stristr() - Versión insensible a mayúsculas y minúsculas de strstr
- strrchr() - Encuentra la última ocurrencia de un carácter en un string
- strpos() - Busca la posición de la primera ocurrencia en un string
- strpbrk() - Busca un conjunto de caracteres en un string
- preg_match() - Realiza una búsqueda de coincidencia con una expresión regular estándar

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open