(PHP 4, PHP 5, PHP 7, PHP 8)
strstr — Encontra a primeira ocorrência de uma string
Retorna parte da string haystack
iniciando a partir da primeira
ocorrência de needle
(inclusive) até o final de
haystack
.
Nota:
Este função é sensível a maiúsculas/minúsculas. Para pesquisas insensíveis a maiúsculas/minúsculas, use stristr().
Nota:
Se for necessário apenas determinar se um
needle
em particular ocorre dentro dehaystack
, a função mais rápida e que consome menos memória, str_contains(), deve ser usada em seu lugar.
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 foi descontinuado 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).
Retorna a parte da string ou false
se needle
não for encontrada.
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 foi descontinuado.
|
Exemplo #1 Exemplo de strstr()
<?php
$email = 'nome@exemplo.com';
$domain = strstr($email, '@');
echo $domain; // mostra @exemplo.com
$user = strstr($email, '@', true);
echo $user; // mostra nome
?>