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() - Знаходить відповідність регулярному виразу за допомогою багатобайтових символів без урахування регістру