mb_strpos

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

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

Описание

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

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

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

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

haystack: Строка, в которой требуется найти позицию первого вхождения подстроки string.
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() - Ищет позицию первого вхождения подстроки

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

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

＋Добавить

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

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