Функция PHP preg_match()
❮ Справочник по регулярному выражению PHP
Пример
Используйте регулярное выражение для поиска «w3schools» в строке без учета регистра:
<?php
$str = "Visit W3Schools";
$pattern = "/w3schools/i";
echo
preg_match($pattern, $str);
?>
Определение и использование
Функция preg_match()
возвращает, было ли найдено совпадение в строке.
Синтаксис
preg_match(pattern, input, matches, flags, offset)
Значения параметров
Parameter | Description |
---|---|
pattern | Required. Contains a regular expression indicating what to search for |
input | Required. The string in which the search will be performed |
matches | Optional. The variable used in this parameter will be populated with an array containing all of the matches that were found |
flags | Optional. A set of options that change how the matches array is
structured:
|
offset | Optional. Defaults to 0. Indicates how far into the string to begin searching. The preg_match() function will not find matches that occur before the position given in this parameter |
Технические детали
Возвращаемое значение: | Возвращает 1, если совпадение найдено, 0, если совпадений не найдено, и false, если произошла ошибка |
---|---|
Версия PHP: | 4+ |
Список изменений: | PHP 7.2 — Добавлен флаг PREG_UNMATCHED_AS_NULL PHP 5.3.6 — Функция возвращает false, если смещение больше длины входных данных PHP 5.2.2 — Именованные подшаблоны могут использовать (?'name') и (? <name>) синтаксис в дополнение к предыдущему (?P<name>) |
Дополнительные примеры
Пример
Используйте PREG_OFFSET_CAPTURE, чтобы найти позицию во входной строке, в которой были найдены совпадения:
<?php
$str = "Welcome to W3Schools";
$pattern = "/w3schools/i";
preg_match($pattern, $str, $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>
❮ Справочник по регулярному выражению PHP