strstr

(PHP 4, PHP 5, PHP 7, PHP 8)

strstr — Encontra a primeira ocorrência de uma string

Descrição

strstr(string $haystack, string $needle, bool $before_needle = false): string|false

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

Note:

Este função é sensível a maiúsculas/minúsculas. Para pesquisas insensíveis a maiúsculas/minúsculas, use stristr().

Note:

Se for necessário apenas determinar se um needle em particular ocorre dentro de haystack, a função mais rápida e que consome menos memória, str_contains(), deve ser usada em seu lugar.

Parâmetros

haystack

A string de entrada.

needle

A string sendo procurada.

Antes do PHP 8.0.0, se needle não for uma string, ela será convertida para um número inteiro e aplicada como o valor ordinal de um caractere. Este comportamento tornou-se defasado a partir do PHP 7.3.0 e depender dele é altamente desaconselhado. Dependendo do comportamento pretendido, o parâmetro needle deve ser explicitamente convertido em string ou uma chamada explícita para chr() deve ser realizada.

before_needle

Se for igual a true, strstr() retorna a parte de haystack antes da primeira ocorrência de needle (excluindo este último).

Valor Retornado

Retorna a parte da string ou false se needle não for encontrada.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro needle agora aceita uma string vazia.
8.0.0 Passar um int em needle não é mais suportado.
7.3.0 Passar um int em needle tornou-se defasado.

Exemplos

Example #1 Exemplo de strstr()

<?php
$email  = '[email protected]';
$domain = strstr($email, '@');
echo $domain; // mostra @exemplo.com

$user = strstr($email, '@', true);
echo $user; // mostra nome
?>

Veja Também

  • stristr() - strstr insensível a maiúsculas/minúsculas
  • strrchr() - Encontra a última ocorrência de um caractere em uma string
  • strpos() - Encontra a posição da primeira ocorrência de uma substring em uma string
  • strpbrk() - Procura na string por um dos caracteres de um conjunto
  • preg_match() - Realiza uma correspondência com expressão regular