preg_splitРазбивает строку по регулярному выражению
&reftitle.description;
arrayfalsepreg_splitstringpatternstringsubjectintlimit-1intflags0
Разбивает строку по регулярному выражению.
&reftitle.parameters;
pattern
Строка, содержащая искомый шаблон.
subject
Входная строка.
limit
Если указан, функция возвращает не более, чем
limit подстрок. Оставшаяся часть строки
будет возвращена в последней подстроке. Специальное значение
limit, равное -1 или 0,
подразумевает отсутствие ограничения.
flagsflags может быть любой комбинацией
следующих флагов (объединённых с помощью побитового оператора
|):
PREG_SPLIT_NO_EMPTY
Если указан этот флаг, функция
preg_split вернёт только непустые подстроки.
PREG_SPLIT_DELIM_CAPTURE
Если указан этот флаг, выражение, заключённое в круглые
скобки в разделяющем шаблоне, также извлекается из
заданной строки и возвращается функцией.
PREG_SPLIT_OFFSET_CAPTURE
Если указан этот флаг, для каждой найденной
подстроки будет указана её позиция в исходной строке.
Необходимо помнить, что этот флаг меняет формат
возвращаемого массива: каждый элемент будет содержать
массив, содержащий в индексе с номером 0
найденную подстроку, а смещение этой подстроки в параметре
subject - в индексе 1.
&reftitle.returnvalues;
Возвращает массив, состоящий из подстрок заданной строки
subject, которая разбита по границам,
соответствующим шаблону pattern&return.falseforfailure;.
&reftitle.errors;
&pcre.pattern.warning;
&reftitle.examples;
preg_split пример: Получение подстрок из заданного текста
]]>
&example.outputs;
hypertext
[1] => language
[2] => programming
)
]]>
Разбиваем строку на составляющие символы
]]>
&example.outputs;
s
[1] => t
[2] => r
[3] => i
[4] => n
[5] => g
)
]]>
Разбиваем строку с указанием смещения для каждой из найденных подстрок
]]>
&example.outputs;
Array
(
[0] => hypertext
[1] => 0
)
[1] => Array
(
[0] => language
[1] => 10
)
[2] => Array
(
[0] => programming
[1] => 19
)
)
]]>
&reftitle.notes;
Если вам не нужна мощь регулярных выражений, вы можете выбрать
более быстрые (хоть и простые) альтернативы наподобие explode
или str_split.
Если соответствий не нашлось, то возвращается массив с единственным элементом равным всей строке.
&reftitle.seealso;
"Регулярные выражения PCRE"preg_quoteexplodepreg_matchpreg_match_allpreg_replacepreg_last_error