Parametry

pattern

Wzorzec do wyszukiwania, jako ciąg znaków.

subject

ciąg wejściowy.

matches

Jeśli dopasowóje się, jest on wypełniany wynikami wyszukiwania. $matches[0] będzie zawierał tekst, który w pełni odpowiada wzorcowi, $matches [1] będzie miał tekst, który pasuje  pierwszemu przejentemu  podwzorcowi, i tak dalej.

flags
flagi mogą być następujące:

 

 

PREG_OFFSET_CAPTURE

If this flag is passed, for every occurring match the appendant string offset will also be returned. Note that this changes the return value in an array where every element is an array consisting of the matched string at index 0 and its string offset into subject at index 1.

offset

Normalnie, wyszukiwanie rozpoczyna się od początku a}cucha ynakw. Opcjonalny parametr offset moe być wykorzystanz, aby określić miejsce, z którego ma si roypocy wzsyukiwanie (w bajtach).

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



Powyższy przykład wyświetli:

Array
(
)

podczas gdy np

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



 

będzie produkować

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

)