関数 preg_match_all

関数 preg_match_all は、文字列内でパターンのグローバル検索を実行します。第一引数には正規表現、第二引数には検索対象の文字列、第三引数には結果を保存する配列を渡します。第四のオプション引数は返される構造のタイプを決定し、第五のオプション引数は検索開始のオフセットを指定します。

構文

phppreg_match_all(pattern, subject, matches, [flags], [offset]);

フラグ

第四引数が取り得る値を見てみましょう：

パラメータ	説明
`PREG_PATTERN_ORDER`	デフォルトのモードです。結果はキャプチャグループごとにグループ化されます - 配列の0番目の要素は0番目のキャプチャグループを含み、 1番目の要素は1番目のキャプチャグループを含みます。以降も同様です。
`PREG_SET_ORDER`	結果はマッチごとにグループ化されます - 配列の各要素は、見つかったキャプチャグループを含む配列です。
`PREG_OFFSET_CAPTURE`	各マッチについて、文字列内での位置が返されます。各結果は配列で、0番目の要素はマッチした文字列、 1番目の要素はそのオフセットを含みます。
`PREG_UNMATCHED_AS_NULL`	マッチしなかったキャプチャグループは、空文字列の代わりに `null` として返されます。

例

文字列内のすべての数字を検索します：

php<?php
  $str = 'abc 123 def 456';
  preg_match_all('/\d+/', $str, $res);
  var_dump($res[0]);
?>

コード実行結果：

php['123', '456']

例

文字列内のすべての文字 'a' を検索します：

php<?php
  $str = 'banana';
  preg_match_all('/a/', $str, $res);
  var_dump($res[0]);
?>

コード実行結果：

php['a', 'a', 'a']

例

文字列からすべてのタイムスタンプとその構成要素を抽出します：

php<?php
  $time = '12:01:02 13:03:04 14:05:06';
  preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res);
  var_dump($res);
?>

コード実行結果：

php[
  0 => ['12:01:02', '13:03:04', '14:05:06'],
  1 => ['12', '13', '14'],
  2 => ['01', '03', '05'],
  3 => ['02', '04', '06']
]

例

次に、フラグ PREG_SET_ORDER を使用してマッチごとにグループ化してみます：

php<?php
  $time = '12:01:02 13:03:04 14:05:06';
  preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res, PREG_SET_ORDER);
  var_dump($res);
?>

コード実行結果：

php[
  0 => '12:01:02',
  1 => '12',
  2 => '01',
  3 => '02'
],
[
  0 => '13:03:04',
  1 => '13',
  2 => '03',
  3 => '04'
],
[
  0 => '14:05:06',
  1 => '14',
  2 => '05',
  3 => '06'
]

関数 preg_match_all

構文

フラグ

例

例

例

例

関連項目