PHP preg_split() 関数

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 の設定をスキップできます。

  • $flags: オプション。以下のフラグの任意の組み合わせ(ビットOR演算 | で組み合わせ)を使用できます:

    • PREG_SPLIT_NO_EMPTY: このフラグが設定されている場合、preg_split() は分割された結果の空でない部分のみを返します。
    • PREG_SPLIT_DELIM_CAPTURE: このフラグが設定されている場合、区切りに使用するパターン内の括弧で囲まれた式がキャプチャされて返されます。
    • PREG_SPLIT_OFFSET_CAPTURE: このフラグが設定されている場合、一致する各出現に対して、返される際に文字列オフセットが追加されます。注意:これにより、返される配列の各要素が、0番目の要素が分割後の部分文字列、1番目の要素がその部分文字列の subject 内でのオフセットである配列に変わります。

戻り値

pattern を境界として subject を分割して得られた部分文字列からなる配列を返します。

例

検索文字列の一部を取得する

<?php //カンマまたはスペース(" ", \r, \t, \n, \f を含む)を使用してフレーズを分割します。 $keywords = preg_split("/[\s,]+/", "hypertext language, programming"); print_r($keywords); ?>

実行結果は次のとおりです:

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

文字列を構成する文字に分割する

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

文字列を分割し、各部分のオフセットを取得する

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

その他の拡張機能