regex_match Function

Artículo
02/19/2013

Coincide con una expresión regular.

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);

Parámetros

BidIt
El iterador escrito para subcoincidencias.
Alloc
La coincidencia resultados clase de asignador.
Elem
El tipo de elementos que se va a comparar.
RXtraits
Clase de los rasgos para elementos.
Alloc2
La clase del asignador de expresiones regulares.
IOtraits
la clase de los rasgos de la cadena.
IOalloc
La clase del asignador de la cadena.
flags
Solicita las coincidencias.
first
Principio de la secuencia que se va a comparar.
last
Final de la secuencia que se va a comparar.
match
los resultados de la coincidencia.
ptr
Puntero al inicio de la secuencia que se va a comparar.
re
La expresión regular que se va a comparar.
str
Cadena que se va a comparar.

Comentarios

Cada función de la plantilla devuelve true solo si coincide con la secuencia de operando exactamente su argumento rede expresiones regulares.Las funciones que toman un objeto de match_results establecen sus miembros para reflejar si la coincidencia correcta y si tan qué diferentes grupos de captura en la expresión regular capturaron.

Ejemplo

// 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); 
    }