mb_ereg_search_pos

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

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

Описание

mb_ereg_search_pos(?string $pattern = null, ?string $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