[#BloombergLP-bdlpcre-RegEx-matchRaw-088]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlpcre.adoc[bdlpcre]::xref:BloombergLP/bdlpcre/RegEx.adoc[RegEx]::matchRaw
:relfileprefix: ../../../
:mrdocs:

`matchRaw` overloads

== Synopses

Declared in `<bdlpcre_regex.h>`

Match the specified `subject` against `pattern()`. Begin matching at the optionally specified `subjectOffset` in `subject`. If `subjectOffset` is not specified, matching begins at the start of `subject`. Return `k_STATUS_SUCCESS` on success, `k_STATUS_NO_MATCH` if a match is not found, and another value if an error occurs. If the returned status is not `k_STATUS_SUCCESS` or `k_STATUS_NO_MATCH` it may match one of specific `k_STATUS_*` error return constants defined above (but is not guaranteed to). The behavior is undefined unless `true == isPrepared()`, `subjectOffset <= subject.length()`, and `subject` is valid UTF‐8 if `pattern()` was prepared with `k_FLAG_UTF8`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-089.adoc[matchRaw](
    std::string_view const& subject,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-089.adoc[_» more..._]#

Match the specified `subject` against `pattern()`. Begin matching at the optionally specified `subjectOffset` in `subject`. If `subjectOffset` is not specified, matching begins at the start of `subject`. Return `k_STATUS_SUCCESS` on success, `k_STATUS_NO_MATCH` if a match is not found, and another value if an error occurs. If the returned status is not `k_STATUS_SUCCESS` or `k_STATUS_NO_MATCH` it may match one of specific `k_STATUS_*` error return constants defined above (but is not guaranteed to). `result` is unchanged if a value other than `k_STATUS_SUCCESS` is returned. The behavior is undefined unless `true == isPrepared()`, `subjectOffset <= subject.length()`, and `subject` is valid UTF‐8 if `pattern()` was prepared with `k_FLAG_UTF8`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-0b.adoc[matchRaw](
    std::string_view* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-0b.adoc[_» more..._]#

Match `subject` against `pattern()` without UTF‐8 validation overhead, loading subpattern matches into `result`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-057.adoc[matchRaw](
    xref:bsl/vector-00d.adoc[bsl::vector<std::string_view>]* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-057.adoc[_» more..._]#

Same as the preceding overload, using a `std::pmr::vector` buffer.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-052.adoc[matchRaw](
    std::pmr::vector<std::string_view>* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-052.adoc[_» more..._]#

Same as the preceding overload, using a `std::vector` result buffer.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-054.adoc[matchRaw](
    std::vector<std::string_view>* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-054.adoc[_» more..._]#

Match the specified `subject` having the specified `subjectLength` against `pattern()`. Begin matching at the optionally specified `subjectOffset` in `subject`. If `subjectOffset` is not specified, matching begins at the start of `subject`. `subject` may contain embedded null characters. Return `k_STATUS_SUCCESS` on success, `k_STATUS_NO_MATCH` if a match is not found, and another value if an error occurs. If the returned status is not `k_STATUS_SUCCESS` or `k_STATUS_NO_MATCH` it may match one of specific `k_STATUS_*` error return constants defined above (but is not guaranteed to). The behavior is undefined unless `true == isPrepared()`, `subject || 0 == subjectLength`, `subjectOffset <= subjectLength`, and `subject` is valid UTF‐8 if `pattern()` was prepared with `k_FLAG_UTF8`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-002.adoc[matchRaw](
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-002.adoc[_» more..._]#

Same as the preceding overload, loading a `string_view` match result.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-06.adoc[matchRaw](
    std::string_view* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-06.adoc[_» more..._]#

Match the specified `subject` having the specified `subjectLength` against `pattern()`. Begin matching at the optionally specified `subjectOffset` in `subject`. If `subjectOffset` is not specified, matching begins at the start of `subject`. `subject` may contain embedded null characters. Return `k_STATUS_SUCCESS` on success, `k_STATUS_NO_MATCH` if a match is not found, and another value if an error occurs. If the returned status is not `k_STATUS_SUCCESS` or `k_STATUS_NO_MATCH` it may match one of specific `k_STATUS_*` error return constants defined above (but is not guaranteed to). `result` is unchanged if a value other than `k_STATUS_SUCCESS` is returned. The behavior is undefined unless `true == isPrepared()`, `subject || 0 == subjectLength`, `subjectOffset <= subjectLength`, and `subject` is valid UTF‐8 if `pattern()` was prepared with `k_FLAG_UTF8`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-007.adoc[matchRaw](
    xref:bsl/pair-0b.adoc[bsl::pair<size_t, size_t>]* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-007.adoc[_» more..._]#

Same as the preceding overload, loading `StringRef` match results.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-09.adoc[matchRaw](
    xref:bsl/vector-00d.adoc[bsl::vector<bslstl::StringRef>]* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-09.adoc[_» more..._]#

Match the specified `subject` having the specified `subjectLength` against `pattern()`. Begin matching at the optionally specified `subjectOffset` in `subject`. If `subjectOffset` is not specified, matching begins at the start of `subject`. `subject` may contain embedded null characters. On success:


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlpcre/RegEx/matchRaw-0f.adoc[matchRaw](
    xref:bsl/vector-00d.adoc[bsl::vector<bsl::pair<size_t, size_t>>]* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;
----

[.small]#xref:BloombergLP/bdlpcre/RegEx/matchRaw-0f.adoc[_» more..._]#


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