preg_match

參數

pattern

要搜尋的模式，為字串。

subject

輸入字串。

matches

如果提供 matches，則會以搜尋結果填入。 $matches[0] 將包含符合完整模式的文字，$matches[1] 將包含符合第一個捕獲的帶括號的子模式的文字，依此類推。

flags

flags 可以是以下旗標的組合

PREG_OFFSET_CAPTURE

如果傳遞此旗標，則對於每次出現的匹配，也會返回附加的字串偏移量（以位元組為單位）。請注意，這會將 matches 的值變更為陣列，其中每個元素都是一個陣列，該陣列由偏移量為 0 的匹配字串及其在 subject 中偏移量為 1 的字串偏移量組成。

<?php
preg_match('/(foo)(bar)(baz)/', 'foobarbaz', $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>

上述範例將輸出

Array
(
    [0] => Array
        (
            [0] => foobarbaz
            [1] => 0
        )

    [1] => Array
        (
            [0] => foo
            [1] => 0
        )

    [2] => Array
        (
            [0] => bar
            [1] => 3
        )

    [3] => Array
        (
            [0] => baz
            [1] => 6
        )

)

PREG_UNMATCHED_AS_NULL

如果傳遞此旗標，則未匹配的子模式會回報為 null；否則，它們會回報為空的 string。

<?php
preg_match('/(a)(b)*(c)/', 'ac', $matches);
var_dump($matches);
preg_match('/(a)(b)*(c)/', 'ac', $matches, PREG_UNMATCHED_AS_NULL);
var_dump($matches);
?>

上述範例將輸出

array(4) {
  [0]=>
  string(2) "ac"
  [1]=>
  string(1) "a"
  [2]=>
  string(0) ""
  [3]=>
  string(1) "c"
}
array(4) {
  [0]=>
  string(2) "ac"
  [1]=>
  string(1) "a"
  [2]=>
  NULL
  [3]=>
  string(1) "c"
}

offset

一般來說，搜尋從主體字串的開頭開始。選用參數 offset 可用於指定開始搜尋的替代位置（以位元組為單位）。

注意:

使用 offset 不等同於將 substr($subject, $offset) 傳遞給 preg_match() 來代替主體字串，因為 pattern 可以包含斷言，例如 ^、$ 或 (?<=x)。比較

<?php
$subject = "abcdef";
$pattern = '/^def/';
preg_match($pattern, $subject, $matches, PREG_OFFSET_CAPTURE, 3);
print_r($matches);
?>

上述範例將輸出

Array
(
)

而此範例

<?php
$subject = "abcdef";
$pattern = '/^def/';
preg_match($pattern, substr($subject,3), $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>

將產生

Array
(
    [0] => Array
        (
            [0] => def
            [1] => 0
        )

)

或者，為了避免使用 substr()，請使用 \G 斷言，而非 ^ 定位符，或改用 A 修飾符，兩者都與 offset 參數搭配使用。