mb_stristr
(PHP 5 >= 5.2.0)
mb_stristr — Finds first occurrence of a string within another, case insensitive
Description
$haystack
, string $needle
[, bool $before_needle = false
[, string $encoding = mb_internal_encoding()
]] )
mb_stristr() finds the first occurrence of
needle in haystack
and returns the portion of haystack.
Unlike mb_strstr(),
mb_stristr() is case-insensitive.
If needle is not found, it returns FALSE.
Parameters
-
haystack -
The string from which to get the first occurrence of
needle -
needle -
The string to find in
haystack -
before_needle -
Determines which portion of
haystackthis function returns. If set toTRUE, it returns all ofhaystackfrom the beginning to the first occurrence ofneedle(excluding needle). If set toFALSE, it returns all ofhaystackfrom the first occurrence ofneedleto the end (including needle). -
encoding -
Character encoding name to use. If it is omitted, internal character encoding is used.
Return Values
Returns the portion of haystack,
or FALSE if needle is not found.
See Also
- stristr() - Case-insensitive strstr
- strstr() - Find the first occurrence of a string
- mb_strstr() - Finds first occurrence of a string within another
- 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.