mb_strpos

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_strpos — Ищет в строке позицию первого вхождения подстроки

Описание

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

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

Функция выполняет безопасную многобайтовую операцию strpos() на основе количества символов, а не байтов. Первый символ стоит на позиции 0, позиция второго символа — 1 и так далее.

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

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

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

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

Ошибки

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

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

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

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

mb_internal_encoding() - Устанавливает или получает внутреннюю кодировку символов файла скрипта
strpos() - Ищет позицию первого вхождения подстроки

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы