全域性 RegExp 匹配

一個全域性性的 RegExp 匹配可以用 preg_match_all 進行。preg_match_all 返回主題字串中的所有匹配結果(與 preg_match 相反,preg_match 僅返回第一個)。

preg_match_all 函式返回匹配數。第三個引數 $matches 將包含由可在第四個引數中給出的標誌控制的格式的匹配。

如果給定一個陣列,$matches 將包含與 preg_match 相似的格式的陣列,除了 preg_match 在第一次匹配時停止,其中 preg_match_all 遍歷字串直到字串被完全消耗並返回多維陣列中每次迭代的結果,哪種格式可以由第四個引數中的標誌控制。

第四個引數 $flags 控制 $matches 陣列的結構。預設模式是 PREG_PATTERN_ORDER,可能的標誌是 PREG_SET_ORDERPREG_PATTERN_ORDER

以下程式碼演示了 preg_match_all 的用法:

$subject = "a1b c2d3e f4g";
$pattern = '/[a-z]([0-9])[a-z]/';

var_dump(preg_match_all($pattern, $subject, $matches, PREG_SET_ORDER)); // int(3)
var_dump($matches);
preg_match_all($pattern, $subject, $matches); // the flag is PREG_PATTERN_ORDER by default
var_dump($matches);
// And for reference, same regexp run through preg_match()
preg_match($pattern, $subject, $matches);
var_dump($matches);

PREG_SET_ORDER 的第一個 var_dump 給出了這個輸出:

array(3) {
  [0]=>
  array(2) {
    [0]=>
    string(3) "a1b"
    [1]=>
    string(1) "1"
  }
  [1]=>
  array(2) {
    [0]=>
    string(3) "c2d"
    [1]=>
    string(1) "2"
  }
  [2]=>
  array(2) {
    [0]=>
    string(3) "f4g"
    [1]=>
    string(1) "4"
  }
}

$matches 有三個巢狀陣列。每個陣列代表一個匹配,其格式與 preg_match 的返回結果相同。

第二個 var_dump(PREG_PATTERN_ORDER)給出了這個輸出:

array(2) {
  [0]=>
  array(3) {
    [0]=>
    string(3) "a1b"
    [1]=>
    string(3) "c2d"
    [2]=>
    string(3) "f4g"
  }
  [1]=>
  array(3) {
    [0]=>
    string(1) "1"
    [1]=>
    string(1) "2"
    [2]=>
    string(1) "4"
  }
}

當通過 preg_match 執行相同的正規表示式時,將返回以下陣列:

array(2) {
  [0] =>
  string(3) "a1b"
  [1] =>
  string(1) "1"
}