создание и продвижение сайта (вбиваю в ТОП-10, как гвозди)Настройка и сопровождение платной рекламы яндекс.директ

split - Разбиение строки на массив по регулярному выражению

(PHP4, PHP5)

split - Разбиение строки на массив по регулярному выражению

Описание

array split(string $pattern,string $string[,int $limit=-1])

Разбивает строку string на массив по регулярному выражению.

Внимание. С версии PHP 5.3.0 эта функция считается устаревшей. Крайне не рекомендуется полагаться на эту возможность.

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

pattern

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

Если необходимо разбить строку по символам, являющимся специальными для регулярных выражений, их следует экранировать. Если вам кажется, что split() (или любая другая функция, работающая с регулярными выражениями) ведет себя неожиданно, пожалуйста, прочтите файл regex.7, расположенный в поддиректории regex/ дистрибутива PHP. Он сохранен в формате manpage, поэтому для удобства чтения используйте команду man /usr/local/src/regex/regex.7.

string

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

limit

Если указан параметр limit, возвращаемый массив будет содержать максимум limit элементов, причем последний элемент будет включать всю оставшуюся часть строки string.

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

Возвращает массив строк, каждая из которых является строкой, образованной разбиением строки string чувствительным к регистру регулярным выражением pattern.

Если pattern встречается n раз, результирующий массив будет содержать n+1 элементов. Например, если pattern в строке отсутствует, будет возвращен массив, содержащий 1 элемент. Само собой, это также верно в случае, когда string является пустой строкой. В случае ошибки split() возвращает FALSE.

Примеры

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

Получаем первые 4 поля строки из /etc/passwd:

<?list($user,$pass,$uid,$gid,$extra)=split(":",$passwd_line,5)?>

Пример 2. Пример использования split()

Распознаем дату, отформатированную с использованием слешей, точек или дефисов:

<?//Разделителями могут быть слеши, точки или дефисы

$date="04/30/1973";list($month,$day,$year)=split('[/.-]',$date);echo"Месяц: $month; День: $day; Год: $year"?>

Примечания

Замечание:

С версии PHP 5.3.0, расширение regex помечено устаревшим и заменено расширением PCRE. Вызов этой функции приведет к ошибке уровня E_DEPRECATED. Смотрите список отличий для помощи при конвертировании в PCRE.

Подсказка:

Функция split() является устаревшей начиная с PHP 5.3.0. Предлагается использовать вместо неё функцию preg_split(). В случае, когда нет необходимости использовать регулярные выражения, эффективнее использовать explode(), которая не использует дополнительныересурсы для разбора регулярного выражения.

Подсказка:

Пользователям, которым необходимо эмулировать поведение @chars=split('',$str) из Perl, следует обратиться к примерам для preg_split() или str_split().

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

Вернуться к: Функции регулярных выражений POSIX

Отвечу на любые вопросы. С уважением, Дмитрий Владимирович.

Ваше письмо×
Free Web Hosting