ereg

(PHP 4, PHP 5)

ereg — Совпадение с регулярным выражением

Внимание

Эта функция объявлена УСТАРЕВШЕЙ в PHP 5.3.0, и УДАЛЕНА PHP 7.0.0.

Есть следующие альтернативы:

preg_match()

Описание

ereg ( string $pattern , string $string , array &$regs = ? ) : int

Ищет в строке string совпадения с регулярным выражением, заданным в pattern регистрозависимым образом.

Список параметров

pattern

Регулярное выражение, чувствительное к регистру.

string

Входная строка.

regs

Если совпадения найдены для подстрок в скобках из pattern, и функция вызывается с третьим аргументом regs, совпадения будут сохранены в элементах массива regs.

$regs[1] будет содержать подстроку, которая начинается с первой левой круглой скобки; $regs[2] будет содержать подстроку, начинающуюся со второй, и т.д. $regs[0] будет содержать полную копию совпавшей строки.

Возвращаемые значения

Возвращает длину совпавшей строки, если совпадение c pattern найдено в string, или false, если совпадений не было или возникла ошибка.

Если необязательный параметр regs не передан, или длина совпавшей строки равна 0, функция возвращает 1.

Список изменений

Версия Описание

4.1.0 Вплоть до (и включая) PHP 4.1.0 $regs будет заполняться точно десятью элементами, хотя реально может совпасть больше или меньше десяти подстрок в скобках. Это не влияет на способность ereg() совпадать с большим количеством подстрок. Если совпадения не найдены, $regs не будет изменен функцией ereg().

Версия	Описание
4.1.0	Вплоть до (и включая) PHP 4.1.0 `$regs` будет заполняться точно десятью элементами, хотя реально может совпасть больше или меньше десяти подстрок в скобках. Это не влияет на способность ereg() совпадать с большим количеством подстрок. Если совпадения не найдены, `$regs` не будет изменен функцией ereg().

Примеры

Пример #1 Пример использования ereg()

Следующий фрагмент кода принимает дату в формате ISO (YYYY-MM-DD) и печатает её в формате DD.MM.YYYY:


<?php
if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs)) {
    echo "$regs[3].$regs[2].$regs[1]";
} else {
    echo "Недопустимый формат даты: $date";
}
?>

Смотрите также

eregi() - Совпадение с регулярным выражением без учёта регистра
ereg_replace() - Осуществляет замену по регулярному выражению
eregi_replace() - Осуществляет замену по регулярному выражению без учета регистра
preg_match() - Выполняет проверку на соответствие регулярному выражению
strpos() - Возвращает позицию первого вхождения подстроки
strstr() - Находит первое вхождение подстроки
quotemeta() - Экранирует специальные символы