match overloads

Synopses

Declared in <bdlpcre_regex.h>

Match the specified subject against pattern().

int
match(
    std::string_view const& subject,
    size_t subjectOffset = 0) const;

Match subject against pattern(), loading the match into result.

int
match(
    std::string_view* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;

Match subject against pattern(), loading subpattern matches into result.

int
match(
    bsl::vector<std::string_view>* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;

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

int
match(
    std::pmr::vector<std::string_view>* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;

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

int
match(
    std::vector<std::string_view>* result,
    std::string_view const& subject,
    size_t subjectOffset = 0) const;

Match the specified subject against pattern().

int
match(
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;

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

int
match(
    std::string_view* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;

Match subject against pattern(), loading the match offset and length into result.

int
match(
    bsl::pair<size_t, size_t>* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;

Same as the preceding overload, loading StringRef match results.

int
match(
    bsl::vector<bslstl::StringRef>* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;

Match subject against pattern(), loading all sub‐pattern matches into result.

int
match(
    bsl::vector<bsl::pair<size_t, size_t>>* result,
    char const* subject,
    size_t subjectLength,
    size_t subjectOffset = 0) const;

Return Value

k_STATUS_SUCCESS on success, k_STATUS_NO_MATCH if no match, or another status on error

Parameters

Name

Description

subject

subject string to match

subjectOffset

offset in subject at which matching begins

result

receives the matched substring

subjectLength

length of subject in bytes

Created with MrDocs