[#BloombergLP-bdlpcre-RegEx-match-03]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlpcre.adoc[bdlpcre]::xref:BloombergLP/bdlpcre/RegEx.adoc[RegEx]::match
:relfileprefix: ../../../
:mrdocs:

Match `subject` against `pattern()`, loading subpattern matches into `result`&period; Begin matching at the optionally specified `subjectOffset`&period; UTF&hyphen;8 validity checking is performed on `subject` if `pattern()` was prepared with `k&lowbar;FLAG&lowbar;UTF8`&period; Return `k&lowbar;STATUS&lowbar;SUCCESS` on success&period;

== Synopsis

Declared in `&lt;bdlpcre&lowbar;regex&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
match(
    xref:bsl/vector-00d.adoc[bsl::vector&lt;std::string&lowbar;view&gt;]* result,
    std::string&lowbar;view const& subject,
    size&lowbar;t subjectOffset = 0) const;
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#
