mb_ereg_search_pos

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

mb_ereg_search_pos — Возвращает позицию и длину совпавшего с регулярным выражением участка многобайтовой строки

Описание

mb_ereg_search_pos(string|null $pattern = null, string|null $options = null): array|false

Возвращает позицию и длину совпавшего с регулярным выражением участка заранее определённой многобайтной строки.

Строка для поиска задаётся функцией mb_ereg_search_init(). Если она не задавалась, будет использована строка, заданная ранее.

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

pattern: Шаблон, текст регулярного выражения.
options: Опция поиска. Подробнее смотрите mb_regex_set_options().

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

Массив (array) содержащий два элемента. Первый элемент - смещение в байтах, с которого начинается совпадение относительно начала искомой строки, и второй элемент - длина совпадения в байтах.

В случае ошибки возвращается false.

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

Версия	Описание
8.0.0	`pattern` и `options` теперь допускают значение null.

Примечания

Замечание:
Для этой функции будет использована внутренняя кодировка или кодировка, установленная функцией mb_regex_encoding().

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

mb_regex_encoding() - Устанавливает/получает текущую кодировку для многобайтового регулярного выражения
mb_ereg_search_init() - Инициализация поиска соответствий регулярному выражению многобайтовой строкой и текстом регулярного выражения

add a note

User Contributed Notes 1 note

down

v dot picture at free dot fr ¶

3 years ago


This function is absolutely not multibyte-safe, it actually returns the position of the match as if the string was not multibyte.

The results of this function are exactly the same as if you were using preg_match_all with PREG_OFFSET_CAPTURE, even with the "unicode" flag it's simply NOT working

(Bug report filed)

add a note