mb_stristr
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
mb_stristr — Encontra a primeira ocorrência de uma string dentro de outra, sem diferenciar maiúsculas de minúsculas
Descrição
string
$haystack,string
$needle,bool
$before_needle = false,?string
$encoding = null): string|false
mb_stristr() encontra a primeira ocorrência de
needle em haystack
e retorna a parte de haystack.
Ao contrário de mb_strstr(),
mb_stristr() não faz distinção entre maiúsculas e minúsculas.
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
haystackesta função retorna. Se definido comotrue, retorna todahaystackdesde o início até a primeira ocorrência deneedle(excluindo needle). Se definido comofalse, retorna todahaystackdesde a primeira ocorrência deneedleaté o final (incluindo needle). encoding-
Nome da codificação de caracteres a ser usada. Se omitido, a codificação interna de caracteres é usada.
Valor Retornado
Retorna a parte 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_strstr() - Encontra a primeira ocorrência de uma string em outra