Documentación offline PHP master

stristr

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

stristr

Versión insensible a mayúsculas y minúsculas de

strstr

Descripción#

stristr(string $haystack, string $needle, [bool $before_needle]): string
```php

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

## Parámetros

`haystack`  
La cadena en la que se debe buscar.

`needle`  
La cadena 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`, `stristr` devuelve la parte de `haystack` antes de la primera ocurrencia de `needle` (`needle` excluida).

`needle` y `haystack` se tratan sin tener en cuenta mayúsculas y minúsculas.

## Valores devueltos

Devuelve la parte correspondiente de la cadena. Si `needle` no se encuentra, la función devuelve `false`.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.2.0 | El case folding ya no depende de la configuración local definida con `setlocale`. Solo se realizará el case folding ASCII. Los octetos no-ASCII serán comparados por su valor de octeto. |
| 8.0.0 | `needle` acepta ahora una cadena vacía. |
| 8.0.0 | Pasar un `int` como `needle` ya no está soportado. |
| 7.3.0 | Pasar un `int` como `before_needle` se ha marcado como obsoleto. |

## Ejemplos

Ejemplo con `stristr`
Comprueba si una cadena es encontrada o no

```php

Notas#

[!NOTE] Esta función es segura para sistemas binarios.

Véase también#

strstr, strrchr, stripos, strpbrk, preg_match