Функция PHP preg_split()

PHP 正则表达式(PCRE)Регулярные выражения 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.

Примеры

Получить части строки поиска

<?php //Разделить фразу с помощью запятых или пробелов (включая " ", \r, \t, \n, \f) $keywords = preg_split("/[\s,]+/", "гипертекстовый язык, программирование"); print_r($keywords); ?>

Вывод следующий:

Array
(
    [0] => hypertext
    [1] => language
    [2] => programming
)

Разделить строку на составляющие её символы

<?php $str = 'example'; $chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY); print_r($chars); ?>

Вывод следующий:

Array
(
    [0] => r
    [1] => u
    [2] => n
    [3] => o
    [4] => o
    [5] => b
)

Разделить строку и получить смещение каждой части

<?php $str = 'hypertext language programming'; $chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE); print_r($chars); ?>

Вывод следующий:

Array
(
    [0] => Array
        (
            [0] => hypertext
            [1] => 0
        )

    [1] => Array
        (
            [0] => language
            [1] => 10
        )

    [2] => Array
        (
            [0] => programming
            [1] => 19
        )

)

PHP 正则表达式(PCRE)Регулярные выражения PHP (PCRE)

Другие расширения