strstr

(PHP 4, PHP 5, PHP 7)

strstrEncuentra 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