preg_split

(PHP 3>= 3.0.9, PHP 4)

preg_split - делить строку регулярным выражением.

Описание

array preg_split (string pattern, string subject [, int limit [, int flags]])

Примечание: параметр flags был введён в PHP 4 Beta 3.

Возвращает массив, содержащий подстроки из subject, разделённого по границам совпадений с pattern.

Если limit специфицирован, то будет возвращены только подстроки до limit, а если limit равен -1, это означает "нет ограничения", что используется для специфицирования flags.

flags может быть комбинацией следующих флагов (с помощью битовой операции |):

PREG_SPLIT_NO_EMPTY

Если это флаг установлен, только непустые участки возвращаются функцией preg_split().

PREG_SPLIT_DELIM_CAPTURE

Если это флаг установлен, выражение в скобках в патэрне ограничителя будет захвачено и возвращено. Этот флаг был введён в 4.0.5.

PREG_SPLIT_OFFSET_CAPTURE

Если это флаг установлен, для каждого найденного совпадения будет также возвращено смещение дополнительной строки. Заметьте, что это изменит return-значение в массиве, где каждый элемент является массивом, состоящим из совпавшей строки в смещении 0 и её строкового смещения в subject - в смещении1. Этот флаг доступен, начиная с PHP 4.3.0.

// разделить фразу по любому количеству запятых или пробельных символов, 
// куда входят " ", \r, \t, \n и \f $keywords = preg_split ("/[\s,]+/", "hypertext 
language, programming");

$str 
= 'string'; $chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY); print_r($chars);

$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 ) )

См. также spliti(), split(), implode(), preg_match(), preg_match_all() и preg_replace().