(PHP 5 >= 5.2.0, PHP 7, PHP 8)
mb_stristr — Encuentra la primera ocurrencia de una cadena en otra, sin tener en cuenta la casilla
$haystack,$needle,$before_needle = false,$encoding = null
mb_stristr() encuentra la primera ocurrencia de
needle en haystack
y devuelve la porción de haystack.
A diferencia de mb_strstr(),
mb_stristr() no distingue entre mayúsculas y minúsculas.
Si needle no se encuentra, la función devolverá false.
haystack
La cadena desde la cual se recupera la primera ocurrencia de
needle
needle
La cadena a buscar en haystack
before_needle
Determina qué porción de haystack
devuelve esta función.
Si se establece en true, la función devolverá toda la cadena haystack
desde el principio hasta la primera ocurrencia de needle
(needle excluido).
Si se establece en false, la función devolverá toda la cadena haystack
desde la primera ocurrencia de needle hasta el final
(needle incluido).
encodingNombre del juego de caracteres a utilizar. Si este parámetro se omite, se utiliza el juego de caracteres interno.
Devuelve la porción de haystack,
o false si needle no se encuentra.
| Versión | Descripción |
|---|---|
| 8.0.0 |
needle now accepts an empty string.
|
| 8.0.0 |
encoding is nullable now.
|
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.