mb_stristr
(PHP 5 >= 5.2.0, PHP 7)
mb_stristr — Находит первое вхождение подстроки в строке без учета регистра
Описание
$haystack
, string $needle
[, bool $before_needle
= false
[, string $encoding
= mb_internal_encoding()
]] )
mb_stristr() находит первое вхождение подстроки
needle
в haystack
и возвращает часть haystack
.
В отличие от mb_strstr(),
mb_stristr() не учитывает регистр.
Если needle
не найдена, возвращается FALSE
.
Список параметров
-
haystack
-
Строка, в которой ищется первое вхождение строки
needle
-
needle
-
Строка для поиска в
haystack
-
before_needle
-
Определяет, какую часть строки
haystack
вернет эта функция. Если установленоTRUE
, возвращается частьhaystack
от начала до первого вхожденияneedle
(включая needle). Если установленоFALSE
, возвращается частьhaystack
от первого вхожденияneedle
до конца (исключая needle). -
encoding
-
Название используемой кодировки символов. Если этот параметр опущен, используется внутренняя кодировка.
Возвращаемые значения
Возвращает часть строки haystack
,
или FALSE
, если needle
не найдена.
Смотрите также
- stristr() - Регистронезависимый вариант функции strstr
- strstr() - Находит первое вхождение подстроки
- mb_strstr() - Находит первое вхождение подстроки в строке
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Поддержка языков и кодировок
- Многобайтные строки
- mb_check_encoding
- mb_convert_case
- mb_convert_encoding
- mb_convert_kana
- mb_convert_variables
- mb_decode_mimeheader
- mb_decode_numericentity
- mb_detect_encoding
- mb_detect_order
- mb_encode_mimeheader
- mb_encode_numericentity
- mb_encoding_aliases
- mb_ereg_match
- mb_ereg_replace_callback
- mb_ereg_replace
- mb_ereg_search_getpos
- mb_ereg_search_getregs
- mb_ereg_search_init
- mb_ereg_search_pos
- mb_ereg_search_regs
- mb_ereg_search_setpos
- mb_ereg_search
- mb_ereg
- mb_eregi_replace
- mb_eregi
- mb_get_info
- mb_http_input
- mb_http_output
- mb_internal_encoding
- mb_language
- mb_list_encodings
- mb_output_handler
- mb_parse_str
- mb_preferred_mime_name
- mb_regex_encoding
- mb_regex_set_options
- mb_send_mail
- mb_split
- mb_strcut
- mb_strimwidth
- mb_stripos
- mb_stristr
- mb_strlen
- mb_strpos
- mb_strrchr
- mb_strrichr
- mb_strripos
- mb_strrpos
- mb_strstr
- mb_strtolower
- mb_strtoupper
- mb_strwidth
- mb_substitute_character
- mb_substr_count
- mb_substr
Коментарии
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.