pattern にマッチした境界で分割した subject の部分文字列の配列を返します。
limit が指定された場合、最大 limit 個の部分文字列が返されます。そして、 limit が -1 の場合は「制限が無い」ことを意味します。 これは、flags を指定する場合に有用です。
flags は、次のフラグを組み合わせたものとする (ビット和演算子|で組み合わせる)ことが可能です。
このフラグを設定すると、空文字列でないものだけが preg_split() により返されます。
このフラグを設定すると、文字列分割用のパターン中の カッコによるサブパターンでキャプチャされた値も同時に返されます。 このフラグは PHP 4.0.5 で追加されました。
このフラグを設定した場合、各マッチに対応する文字列のオフセットも返されます。 これにより、返り値は配列となり、配列の要素 0 はマッチした文字列、 要素 1 は subject におけるマッチした文字列のオフセット値となることに 注意してください。 このフラグは、PHP 4.3.0 以降で利用可能です。
ティップ: 正規表現の威力を必要としないのなら、より高速な (機能はシンプルですが) 代替関数として explode() あるいは str_split() のような選択肢があります。
注意: パラメータ flags は、PHP 4 Beta 3 で追加されました。
spliti(), split(), implode(), preg_match(), preg_match_all() および preg_replace() も参照してください。