mb_strstr
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
mb_strstr — Encontra a primeira ocorrência de uma string em outra
Descrição
string
$haystack
,string
$needle
,bool
$before_needle
= false
,?string
$encoding
= null
): string|false
mb_strstr() encontra a primeira ocorrência de
needle
em haystack
e retorna a porção de haystack
.
Se needle
não for encontrado, retorna false
.
Parâmetros
haystack
-
A string da qual obter a primeira ocorrência de
needle
needle
-
A string a ser encontrada em
haystack
before_needle
-
Determina qual parte de
haystack
essa função retorna. Se definido comotrue
, retorna toda ahaystack
desde o início até a primeira ocorrência deneedle
(excluindo needle). Se definido comofalse
, retorna toda ahaystack
da primeira ocorrência deneedle
até o final (incluindo needle). encoding
-
Nome do conjunto de caracteres a ser usado. Se omitido, é utilizado o conjunto de caracteres interno.
Valor Retornado
Retorna a porção de haystack
,
ou false
se needle
não for encontrado.
Registro de Alterações
Versão | Descrição |
---|---|
8.0.0 |
O parâmetro needle agora aceita uma string vazia.
|
8.0.0 |
O parâmetro encoding agora pode ser nulo.
|
Veja Também
- stristr() - strstr insensível a maiúsculas/minúsculas
- strstr() - Encontra a primeira ocorrência de uma string
- mb_stristr() - Encontra a primeira ocorrência de uma string dentro de outra, sem diferenciar maiúsculas de minúsculas