PHP preg_split() 関数
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 の設定をスキップできます。
$flags: オプション。以下のフラグの任意の組み合わせ(ビットOR演算 | で組み合わせ)を使用できます:
- PREG_SPLIT_NO_EMPTY: このフラグが設定されている場合、preg_split() は分割された結果の空でない部分のみを返します。
- PREG_SPLIT_DELIM_CAPTURE: このフラグが設定されている場合、区切りに使用するパターン内の括弧で囲まれた式がキャプチャされて返されます。
- PREG_SPLIT_OFFSET_CAPTURE: このフラグが設定されている場合、一致する各出現に対して、返される際に文字列オフセットが追加されます。注意:これにより、返される配列の各要素が、0番目の要素が分割後の部分文字列、1番目の要素がその部分文字列の subject 内でのオフセットである配列に変わります。
戻り値
pattern を境界として subject を分割して得られた部分文字列からなる配列を返します。
例
検索文字列の一部を取得する
//カンマまたはスペース(" ", \r, \t, \n, \f を含む)を使用してフレーズを分割します。
$keywords = preg_split("/[\s,]+/", "hypertext language, programming");
print_r($keywords);
実行結果は次のとおりです:
Array
(
[0] => hypertext
[1] => language
[2] => programming
)
文字列を構成する文字に分割する
$str = 'サンプル';
$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
)
文字列を分割し、各部分のオフセットを取得する
$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
)
)
その他の拡張機能