Função regex_match

Artigo
06/09/2015

Testa se uma expressão regular corresponde a toda a cadeia de caracteres de destino.

 // (1)  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);  // (2)  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);  // (3) 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);  // (4)  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);  // (5) 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);  // (6) 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);

Parâmetros

BidIt
O tipo de iterador para subcorrespondências. Para casos comuns, é do tipo string::const_iterator, wstring::const_iterator, const char* ou const wchar_t*.
Alloc
A classe alocadora de resultados de correspondência.
Elem
O tipo de elemento a ser correspondido. Para casos comuns, é do tipo string, wstring, char* ou wchar_t*.
RXtraits
Classe de características para elementos.
Alloc2
A classe alocadora de expressão regular.
IOtraits
A classe de característica da cadeia de caracteres.
IOalloc
A classe alocadora da cadeia de caracteres.
flags
Sinalizadores de correspondências.
first
Início da sequência de correspondência.
last
Fim da sequência de correspondência.
match
Os resultados da correspondência. Corresponde ao tipo Elem: smatch para string wsmatch para wstring, cmatch para char* ou wcmatch para wchar_t*.
ptr
Ponteiro para o início da sequência de correspondência. Se ptr for char*, use cmatch e regex. Se ptr for wchar_t*, use wcmatch e wregex.
re
A expressão regular de correspondência. Digite regex para string e char* ou wregex para wstring e wchar_t*.
str
Cadeia de caracteres de correspondência. Corresponde ao tipo de Elem.

Comentários

Cada função de modelo só retornará verdadeiro se toda a sequência de operando str corresponder exatamente ao argumento da expressão regular re. Use regex_search para coincidar uma subcadeia de caracteres dentro de uma sequência de destino e regex_iterator para encontrar várias correspondências.

As funções que utilizam um objeto match_results definem seus membros para refletir se a correspondência foi bem-sucedida e, em caso afirmativo, quais são os diversos grupos de capturas na expressão regular capturada.

(1):

Exemplo

// RegexTestBed.cpp : Defines the entry point for the console application.
//

#include "stdafx.h"
#include <regex> 
#include <iostream> 

using namespace std;

int _tmain(int argc, _TCHAR* argv[])
{
   
    // (1) with char*
    // Note how const char* requires cmatch and regex
    const char *first = "abc";
    const char *last = first + strlen(first);
    cmatch narrowMatch;
    regex rx("a(b?)c");

    bool found = regex_match(first, last, narrowMatch, rx);

    // (1) with std::wstring
    // Note how wstring requires wsmatch and wregex.
    // Note use of const iterators cbegin() and cend().
    wstring target(L"Hello");
    wsmatch wideMatch;
    wregex wrx(L"He(l+)o");

    if (regex_match(target.cbegin(), target.cend(), wideMatch, wrx))
        wcout << L"The matching text is:" << wideMatch.str() << endl; 

    // (2) with std::string
    string target2("Drizzle");
    regex rx2(R"(D\w+e)"); // no double backslashes with raw string literal
    found = regex_match(target2.cbegin(), target2.cend(), rx2);

    // (3) with wchar_t*
    const wchar_t* target3 = L"2014-04-02";
    wcmatch wideMatch2;

    // LR"(...)" is a  raw wide-string literal. Open and close parens
    // are delimiters, not string elements.
    wregex wrx2(LR"(\d{4}(-|/)\d{2}(-|/)\d{2})"); 
    if (regex_match(target3, wideMatch2, wrx2))
    {
        wcout << L"Matching text: " << wideMatch2.str() << endl;
    }
   


     return 0;
}