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

# mb_stripos

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

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

### Описание

function 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() - Ищет в строке позицию первого вхождения подстроки

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open