preg_split

(PHP 3 = 3.0.9, PHP 4 )

preg_split -- 正規表現で文字列を分割する

説明

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

注意 パラメータ flags は、PHP4 Beta3で追加されました。

pattern にマッチした境界で分割した subject の部分文字列を有する配列を返します。

limit が指定された場合、最大 limit 個の部分文字列のみが返されます。そし て、 limit が-1の場合は"制限がない"ことを意 味します。これは、 flags を指定する場合に便 利です。

flags は次のフラグを組み合わせたものとする ことが可能です。(ビット和演算子|で組み合わせる):

PREG_SPLIT_NO_EMPTY

このフラグが設定されている場合、空でないもののみが、 preg_split() により返されます。

PREG_SPLIT_DELIM_CAPTURE

このフラグが設定されている場合、デリミタパターンの括弧で括ら れた式の値が取得され、同時に返されます。このフラグは4.0.5で追 加されました。



例 1 preg_split() の例

検索文字列の部分を取得します。

// " ", \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);

spliti() , split() , implode() , preg_match() , preg_match_all() , preg_replace() も参照下さい。