strstr

(PHP 4, PHP 5)

strstr — Encuentra la primera aparición de un string

Descripción

string strstr ( string $haystack , mixed $needle [, bool $before_needle = false ] )

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 un string, será convertido como número entero y se aplicará el valor ordinal de caracter.

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