Функция PHP preg_match()
Регулярные выражения PHP (PCRE)
Функция preg_match используется для выполнения сопоставления с регулярным выражением.
Синтаксис
int preg_match ( string $pattern , string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )
Ищет в subject совпадение с регулярным выражением, заданным pattern.
Описание параметра:
$pattern: шаблон для поиска, в виде строки.
$subject: входная строка.
$matches: Если параметр matches предоставлен, он будет заполнен результатами поиска. $matches
$flags: flags можно установить в следующие значения флагов:
PREG_OFFSET_CAPTURE: Если этот флаг передан, для каждого вхождения совпадения будет добавлено смещение строки (относительно целевой строки). Примечание: Это изменяет массив, заполняемый в параметр matches, делая каждый элемент массивом, где 0-й элемент — это совпавшая строка, а 1-й элемент — смещение этой совпавшей строки в целевой строке subject.
offset: Обычно поиск начинается с начала целевой строки. Необязательный параметр offset используется для указания начала поиска с определённой позиции в целевой строке (в байтах).
Возвращаемое значение
Возвращает количество совпадений для pattern. Его значение будет 0 (нет совпадений) или 1, потому что preg_match() прекращает поиск после первого совпадения. preg_match_all() отличается; он продолжает поиск в subject до достижения конца. Если возникает ошибка, preg_match() возвращает FALSE.
Примеры
Найти текстовую строку "php":
Результат выполнения выглядит следующим образом:
查找到匹配的字符串 php。
Найти слово "web"
Результат выполнения выглядит следующим образом:
Matching string found.
Получить доменное имя из URL
Результат выполнения выглядит следующим образом:
domain name is: example.com
Использование именованных подгрупп
Результат выполнения выглядит следующим образом:
Array
(
[0] => foobar: 2008
[name] => foobar
[1] => foobar
[digit] => 2008
[2] => 2008
)
Другие расширения