eregi - Совпадение с регулярным выражением без учёта регистра
Вернуться к: Функции регулярных выражений POSIX
eregi
(PHP 4, PHP 5)
eregi — Совпадение с регулярным выражением без учёта регистра
Описание
$pattern
, string $string
[, array &$regs
] )Эта функция идентична функции ereg() за исключением того, что игнорирует регистр при сравнении алфавитных символов.
С версии PHP 5.3.0 эта функция считается УСТАРЕВШЕЙ. Крайне не рекомендуется полагаться на эту возможность.
Список параметров
-
pattern
-
Регистронезависимое регулярное выражение.
-
string
-
Входная строка.
-
regs
-
Если совпадения найдены для подстрок в скобках из
pattern
, и функция вызывается с третьим аргументомregs
, совпадения будут сохранены в элементах массиваregs
.$regs[1] будет содержать подстроку, которая начинается с первой левой круглой скобки; $regs[2] будет содержать подстроку, начинающуюся со второй, и т.д. $regs[0] будет содержать полную копию совпавшей строки.
Возвращаемые значения
Возвращает длину совпавшей строки, если совпадения с
pattern
найдены в string
,
или FALSE
, если совпадений не найдено или возникла ошибка.
Если дополнительный параметр regs
не передан,
или длина совпавшей строки равна 0, функция возвращает 1.
Примеры
Пример #1 Пример использования eregi()
<?php
$string = 'XYZ';
if (eregi('z', $string)) {
echo "'$string' содержит 'z' или 'Z'!";
}
?>
Примечания
Замечание:
С версии PHP 5.3.0, расширение regex помечено устаревшим и заменено расширением PCRE. Вызов этой функции приведет к ошибке уровня
E_DEPRECATED
. Смотрите список отличий для помощи при конвертировании в PCRE.
Функция eregi() является устаревшей начиная с PHP 5.3.0.
Предлагается использовать вместо неё функцию preg_match()
с модификатором i (PCRE_CASELESS
).
Смотрите также
- ereg() - Совпадение с регулярным выражением
- ereg_replace() - Осуществляет замену по регулярному выражению
- eregi_replace() - Осуществляет замену по регулярному выражению без учета регистра
- preg_match() - Выполняет проверку на соответствие регулярному выражению
- stripos() - Возвращает позицию первого вхождения подстроки без учета регистра
- stristr() - Регистронезависимый вариант функции strstr
- quotemeta() - Экранирует специальные символы
Вернуться к: Функции регулярных выражений POSIX