mb_ereg

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

mb_ereg — Знаходить збіг регулярного вираження за допомогою багатобайтових кодувань

Опис

mb_ereg(string $pattern, string $string, array &$matches = null): bool

Виконує пошук збігу з регулярним виразом за допомогою багатобайтових кодувань.

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

pattern

Шаблон пошуку.

string

Рядок (string) пошуку.

matches

Якщо знайдені збіги для підстроювання у дужках шаблону pattern та функція викликана з третім аргументом matches, збіги будуть збережені в масиві matches. Якщо збіги не знайдено, то параметром matches буде встановлено значення як порожнього масиву.

Елемент $matches[ ] міститиме перший зліва підрядок у дужках; елемент $matches[ ] - другу і так далі. Елемент $matches[ ] міститиме копію всього рядка.

Значення, що повертаються

Повертає true, якщо шаблон pattern відповідає рядку string, иначе**false**

список змін

ВерсияОпис
8.0.0Тепер у разі успішного завершення ця функція повертає true. . Раніше вона повертала байтову довжину знайденого входження, якщо у рядку string було знайдено збіг шаблону pattern і було встановлено параметр matches. . Якщо необов'язковий параметр matches не було встановлено або довжина рядка, що перевірялася, дорівнювала , функція повертала
7.1.0Теперь функцияmb_ereg() встановлює параметр matches рівним порожньому масиву (array), якщо нічого не знайдено. Раніше параметр matches не змінювався.

Примітки

Зауваження :

Для цієї функції буде використано внутрішнє кодування або кодування, встановлене функцією mb_regex_encoding()

Дивіться також

  • mb_regex_encoding() - Встановлює/отримує кодування символів для однобайтового регулярного виразу
  • mb_eregi() - Знаходить відповідність регулярному виразу за допомогою багатобайтових символів без урахування регістру