ProfiPHPProfiPHP
Категория: Функции для работы с регулярными выражениями (Perl-совместимые)

Функция Preg_match

Функция Preg_match выполняет проверку на соответствие регулярному выражению.
int preg_match( string $pattern, string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )
Функция Preg_match ищет в заданном тексте Subject совпадения с шаблоном Pattern.

Параметр Pattern являет собой искомый шаблон, строку.

В параметре Subject указывается входная строка.

В случае, если указан дополнительный параметр Matches, он будет заполнен результатами поиска. Элемент $matches[0] будет содержать часть строки, соответствующую вхождению всего шаблона, $matches[1] - часть строки, соответствующую первой подмаске, и так далее.

Параметр Flags может принимать значение следующего флага:

PREG_OFFSET_CAPTURE - для каждой найденной подстроки будет указана ее позиция в исходной строке. Необходимо помнить, что этот флаг меняет формат возвращаемого массива Matches в массив, каждый элемент которого содержит массив, содержащий в индексе с номером 0 найденную подстроку, а смещение этой подстроки в параметре Subject - в индексе 1.

Обычно поиск осуществляется слева направо, с начала строки. Можно использовать дополнительный параметр Offset для указания альтернативной начальной позиции для поиска (в байтах).

Функция Preg_match возвращает 1, если параметр Pattern соответствует переданному параметру Subject, 0 если нет, или FALSE в случае ошибки.

Эта функция может возвращать как boolean FALSE, так и не-boolean значение, которое приводится к FALSE. За более подробной информацией посмотрите страницу Двоичные данные (Boolean). Используйте оператор === для проверки значения, возвращаемого этой функцией.

Пример использования:
if ( preg_match( "/three/i", "One two three four five" ) ) {
echo "Вхождение найдено.";
} else {
echo "Вхождение не найдено.";
}

Добавить комментарий

Имя:
Текст комментария: