Совпадение с регулярным выражением без учёта регистра


(PHP 4, PHP 5)

eregiСовпадение с регулярным выражением без учёта регистра

Описание

int eregi ( string $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() - Экранирует специальные символы