Функция PHP preg_split()
Регулярные выражения PHP (PCRE)
Функция preg_split разбивает строку с помощью регулярного выражения.
Синтаксис
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )
Разбивает заданную строку с помощью регулярного выражения.
Описание параметров:
$pattern: шаблон для поиска, в виде строки.
$subject: входная строка.
$limit: Необязательный. Если указан, ограничивает количество возвращаемых подстрок значением не более limit, и последняя подстрока будет содержать все оставшиеся части. Значение limit, равное -1, 0 или null, означает "без ограничения". В соответствии со стандартом PHP можно использовать null, чтобы пропустить установку флагов.
$flags: Необязательный. Может быть любой комбинацией следующих флагов (объединяемых побитовым ИЛИ |):
- PREG_SPLIT_NO_EMPTY: Если этот флаг установлен, preg_split() вернёт только непустые части после разделения.
- PREG_SPLIT_DELIM_CAPTURE: Если этот флаг установлен, выражения в круглых скобках в шаблоне разделителя будут захвачены и возвращены.
- PREG_SPLIT_OFFSET_CAPTURE: Если этот флаг установлен, для каждого встречающегося совпадения смещение в строке будет добавлено к возвращаемому значению. Примечание: это изменит каждый элемент возвращаемого массива, делая каждый элемент массивом, состоящим из 0-го элемента — разделённой подстроки, и 1-го элемента — смещения подстроки в subject.
Возвращаемое значение
Возвращает массив подстрок, полученных разделением subject по границам, соответствующим pattern.
Примеры
Получить части строки поиска
Вывод следующий:
Array
(
[0] => hypertext
[1] => language
[2] => programming
)
Разделить строку на составляющие её символы
Вывод следующий:
Array
(
[0] => r
[1] => u
[2] => n
[3] => o
[4] => o
[5] => b
)
Разделить строку и получить смещение каждой части
Вывод следующий:
Array
(
[0] => Array
(
[0] => hypertext
[1] => 0
)
[1] => Array
(
[0] => language
[1] => 10
)
[2] => Array
(
[0] => programming
[1] => 19
)
)
Другие расширения