mb_stripos

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

mb_stripos — Ищет в строке позицию первого вхождения подстроки, без учёта регистра

Описание

mb_stripos(
    string $haystack,
    string $needle,
    int $offset = 0,
    ?string $encoding = null
): int|false

Функция mb_stripos() возвращает позицию первого вхождения подстроки needle в строку haystack. Функция mb_stripos(), в отличие от функции mb_strpos(), не чувствительна к регистру символов. Функция вернёт значение false, если не найдёт в строке подстроку needle.

Список параметров

haystack: Строка, в которой требуется найти позицию первого вхождения подстроки needle.
needle: Подстрока для поиска в строке haystack.
offset: Начальная позиция поиска в строке haystack. Отрицательные смещения отсчитываются с конца строки.
encoding: Параметр encoding указывает кодировку символов. При пропуске параметра или передаче значения null функция интерпретирует символы в предустановленной кодировке модуля.

Возвращаемые значения

Функция возвращает числовую позицию первого вхождения подстроки needle в строку haystack или значение false, если строка не содержит подстроку needle.

Ошибки

Функция выбросит ошибку ValueError, если значение параметра offset превысит длину строки haystack.

Список изменений

Версия	Описание
8.0.0	`needle` теперь принимает пустую строку.
8.0.0	Параметр `encoding` теперь принимает значение `null`.
7.1.0	Добавили поддержку отрицательных значений параметром `offset`.

Смотрите также

stripos() - Возвращает позицию первого вхождения подстроки без учёта регистра
strpos() - Ищет позицию первого вхождения подстроки
mb_strpos() - Ищет в строке позицию первого вхождения подстроки