(PHP 4, PHP 5, PHP 7, PHP 8)
strstr — Encuentra la primera ocurrencia en un string
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 enhaystack
, la función str_contains() que es más rápida y menos exigente en memoria debería ser utilizada en su lugar.
haystack
El string de entrada.
needle
El string a buscar.
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 es true
, strstr() devuelve
la parte de haystack
antes de la primera ocurrencia de
needle
(needle
excluido).
Devuelve la porción del string, o false
si needle
no es encontrado.
Versión | Descripción |
---|---|
8.0.0 |
needle now accepts an empty string.
|
8.0.0 |
Pasar un entier como needle ya no es soportado.
|
7.3.0 |
Pasar un entier como before_needle ha sido
declarado obsoleto.
|
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
?>