mb_strrpos

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

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

Описание

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

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

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

haystack

Строка (string), в которой требуется найти последнее вхождение подстроки needle.

needle

Подстрока (string) для поиска в строке haystack.

offset
Положительные значения указывают произвольную начальную позицию поиска символов в строке haystack. Отрицательные значения остановят поиск в произвольной точке до конца строки haystack.
encoding

Параметр encoding указывает кодировку символов. При пропуске параметра или передаче значения null функция интерпретирует символы в предустановленной кодировке модуля.

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

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

Ошибки

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

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

Версия Описание
8.0.0 needle теперь принимает пустую строку.
8.0.0 Запретили передачу названия кодировки для параметра encoding в третьем аргументе вместо параметра offset.
8.0.0 Параметр encoding теперь принимает значение null.

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

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