regex_match Function

Artykuł
02/27/2013

Dokładnie pasuje do wyrażenia regularnego.

template<class BidIt, class Alloc, class Elem, class RXtraits, class Alloc2>
    bool regex_match(BidIt first, Bidit last,
        match_results<BidIt, Alloc>& match,
        const basic_regex<Elem, RXtraits, Alloc2>& re,
        match_flag_type flags = match_default);
template<class BidIt, class Elem, class RXtraits, class Alloc2>
    bool regex_match(BidIt first, Bidit last,
        const basic_regex<Elem, RXtraits, Alloc2>& re,
        match_flag_type flags = match_default);
template<class Elem, class Alloc, class RXtraits, class Alloc2>
    bool regex_match(const Elem *ptr,
        match_results<const Elem*, Alloc>& match,
        const basic_regex<Elem, RXtraits, Alloc2>& re,
        match_flag_type flags = match_default);
template<class Elem, class RXtraits, class Alloc2>
    bool regex_match(const Elem *ptr,
        const basic_regex<Elem, RXtraits, Alloc2>& re,
        match_flag_type flags = match_default);
template<class IOtraits, class IOalloc, class Alloc, class Elem, class RXtraits, class Alloc2>
    bool regex_match(const basic_string<Elem, IOtraits, IOalloc>& str,
        match_results<typename basic_string<Elem, IOtraits, IOalloc>::const_iterator, Alloc>& match,
        const basic_regex<Elem, RXtraits, Alloc2>& re,
        match_flag_type flags = match_default);
template<class IOtraits, class IOalloc, class Elem, class RXtraits, class Alloc2>
    bool regex_match(const basic_string<Elem, IOtraits, IOalloc>& str,
        const basic_regex<Elem, RXtraits, Alloc2>& re,
        match_flag_type flags = match_default);

Parametry

BidIt
Typ iteratora submatches.
Alloc
Klasa alokatora wyniki dopasowania.
Elem
Typ elementów, aby dopasować.
RXtraits
Cech klasy elementów.
Alloc2
Klasa alokatora wyrażenia regularnego.
IOtraits
Cech klasy string.
IOalloc
Program przydzielania klasy string.
flags
Flagi dla dopasowań.
first
Początkiem sekwencji odpowiadać.
last
Koniec sekwencji odpowiadać.
match
Wyniki dopasowania.
ptr
Wskaźnik na początku sekwencji odpowiadać.
re
Wyrażenie regularne dopasuje.
str
Ciąg pasuje.

Uwagi

Każda funkcja szablonu zwraca wartość true, tylko jeśli dokładnie sekwencji operandu argumentu Wyrażenie regularne re.Funkcje, które match_results obiektu ustawione w swoich członków, aby odzwierciedlić czy dopasowanie powiodło się, a jeśli tak, co przechwytywanie różnych grup w wyrażeniu regularnym przechwycone.

Przykład

// std_tr1__regex__regex_match.cpp 
// compile with: /EHsc 
#include <regex> 
#include <iostream> 
 
int main() 
    { 
    const char *first = "abc"; 
    const char *last = first + strlen(first); 
    std::cmatch mr; 
    std::regex rx("abc"); 
    std::regex_constants::match_flag_type fl = 
        std::regex_constants::match_default; 
 
    std::cout << "match(f, f+1, \"abc\") == " << std::boolalpha 
        << regex_match(first, first + 1, rx, fl) << std::endl; 
 
    std::cout << "match(f, l, \"abc\") == " << std::boolalpha 
        << regex_match(first, last, mr, rx) << std::endl; 
    std::cout << "  matched: \"" << mr.str() << "\"" << std::endl; 
 
    std::cout << "match(\"a\", \"abc\") == " << std::boolalpha 
        << regex_match("a", rx) << std::endl; 
 
    std::cout << "match(\"abc\", \"abc\") == " << std::boolalpha 
        << regex_match("abc", mr, rx) << std::endl; 
    std::cout << "  matched: \"" << mr.str() << "\"" << std::endl; 
 
    std::cout << "match(string, \"abc\") == " << std::boolalpha 
        << regex_match(std::string("a"), rx) << std::endl; 
 
    std::string str("abc"); 
    std::match_results<std::string::const_iterator> mr2; 
    std::cout << "match(string, \"abc\") == " << std::boolalpha 
        << regex_match(str, mr2, rx) << std::endl; 
    std::cout << "  matched: \"" << mr2.str() << "\"" << std::endl; 
 
    return (0); 
    }