(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
$haystack,$needle,$before_needle = false,$encoding = null
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.
haystack
A string da qual obter a primeira ocorrência
de needle
needle
A string a ser encontrada em haystack
before_needlehaystack
esta função retorna.
Se definido como true, retorna toda haystack
desde o início até a primeira ocorrência de needle (excluindo needle).
Se definido como false, retorna toda haystack
desde a primeira ocorrência de needle até o final (incluindo needle).
encodingencoding
é a codificação de caracteres. Se for omitido ou null, o valor da codificação
de caracteres interna será usado.
Retorna a parte de haystack,
ou false se needle não for encontrado.
| 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.
|
Be aware that if needle is an empty string, mb_stristr return the haystack by default.
For exemple:
<?php
if (mb_stristr("foo", "")) {
echo "We enter in condition";
}
?>
Because in the above exemple the return of mb_stristr is "foo".
So if we do not want this kind of behaviour, we must set the third argument, ($before_needle) to true.
<?php
if (mb_stristr("foo", "", true)) {
echo "We do not enter in condition";
}
?>
It can be useful to know it, specially when needle is dynamic.