strstr

(PHP 4, PHP 5)

strstr — Encontra a primeira ocorrencia de uma string

Descrição

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

Retorna parte da string haystack a partir da primeira ocorrência de needle até o final de haystack.

Note:

Esta função diferencia maiúsculas e minúsculas. Para pesquisas que não diferenciem, use stristr().

Note:

Se você quer somente determinar se um específica needle existem em haystack, use a função mais rápida e que usa menos memória ao invés, strpos().

Parâmetros

haystack

A string de entrada.

needle

Se needle não é uma string, é convertido para um inteiro e aplicado como valor ordinal de um caractere.

before_needle

Se TRUE (o padrão é FALSE), strstr() retorna a parte de haystack antes da primeira ocorrência de needle.

Valor Retornado

Retorna a parte da string, ou FALSE se needle não é encontrado.

Changelog

Versão Descrição
5.3.0 Adicionado o parâmetro opcional before_needle.
4.3.0 strstr() tornou-se binary safe.

Exemplos

Example #1 Exemplo da strstr()

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

$user = strstr($email, '@', true); // A partir do PHP 5.3.0
echo $user; // prints name
?>

Veja Também

  • preg_match() - Perform a regular expression match
  • stristr() - strstr sem diferenciar maiúsculas e minúsculas
  • strpos() - Encontra a posição da primeira ocorrência de uma string
  • strrchr() - Encontra a ultima ocorrência de um caractere em uma string
  • substr() - Retorna uma parte de uma string