Описание функции preg-match
preg_match
(PHP 3>= 3.0.9, PHP 4)
preg_match - выполняет подстановку регулярного выражения.
Описание
int preg_match (string pattern, string subject [, array matches [, int flags]])
Ищет в subject совпадения с регулярным выражением, заданным в pattern .
Если matches предоставлен, он заполняется результатами поиска. $matches[0] будет содержать текст, совпавший со всем патэрном, $matches[1] будет содержать текст, совпавший первым захваченным субпатэрном в скобках, и так далее.
flags это:
- PREG_OFFSET_CAPTURE
-
Если этот флаг установлен, для каждого найденного совпадения будет возвращаться сопутствующее строковое смещение. Заметьте, что это изменяет return-значение в массиве, где каждый элемент является массивом, состоящим из совпавшей строки и в смещении 0 и её строковым смещением в subject в смещении 1 . Этот флаг доступен, начиная с PHP 4.3.0.
Параметр flags доступен, начиная с PHP 4.3.0.
preg_match() возвращает количество совпадений pattern . Это будет либо 0 раз (нет совпадений), либо 1 раз, поскольку preg_match() остановит поиск после первого найденного совпадения. preg_match_all() , наоборот, продолжит поиск до достижения конца subject . preg_match() возвращает FALSE при возникновении ошибки.
Пример 2. Найти слово "web"
|
Пример 3. Получение имени домена из URL
Это пример выведет:
|
См. также preg_match_all() , preg_replace() и preg_split() .