Compartilhar via


<regex>

Define um modelo de classe para analisar Expressões Regulares (C++) e vários modelos de classe e funções para pesquisar no texto correspondências de um objeto de expressão regular.

Sintaxe

#include <regex>

Comentários

Para criar um objeto de expressão regular, use o modelo de classe basic_regex Classe ou uma de suas especializações, regex e wregex, junto com os sinalizadores de sintaxe do tiporegex_constants::syntax_option_type.

Para pesquisar texto para correspondências com um objeto de expressão regular, use as funções de modelo regex_match e regex_search junto com os sinalizadores de correspondência de tipo regex_constants::match_flag_type. Essas funções retornam resultados usando o modelo de classematch_results Classe e suas especializações, cmatch, wcmatch, smatch e wsmatch, juntamente com o modelo de classe sub_match Classe e suas especializações csub_match, wcsub_match, ssub_match e wssub_match.

Para substituir o texto que corresponde a um objeto de expressão regular, use a função de modelo regex_replace, junto com os sinalizadores de correspondência do tipo regex_constants::match_flag_type.

Para iterar por meio de várias correspondências de um objeto de expressão regular, use os modelos de classe regex_iterator Classe e regex_token_iterator Classe ou uma de suas especializações, cregex_iterator, sregex_iterator, wcregex_iterator, wsregex_iterator, cregex_token_iterator, sregex_token_iterator, wcregex_token_iteratorou wsregex_token_iterator, juntamente com os sinalizadores de correspondência do tipo regex_constants::match_flag_type.

Para modificar os detalhes da gramática de expressões regulares, grave uma classe que implementa as características da expressão regular.

Classes

Classe Descrição
basic_regex Encapsula uma expressão regular.
match_results Contém uma sequência de subcorrespondências.
regex_constants Retém as constantes sortidas.
regex_error Relata uma expressão regular inválida.
regex_iterator Itera os resultados de correspondência.
regex_traits Descreve as características dos elementos de correspondência.
regex_traits<char> Descreve as características de char para correspondência.
regex_traits<wchar_t> Descreve as características de wchar_t para correspondência.
regex_token_iterator Itera as subcorrespondências.
sub_match Descreve uma subcorrespondência.

Definições de tipo

Nome Descrição
cmatch Definição de tipo para char match_results.
cregex_iterator Definição de tipo para char regex_iterator.
cregex_token_iterator Definição de tipo para char regex_token_iterator.
csub_match Definição de tipo para char sub_match.
regex Definição de tipo para char basic_regex.
smatch Definição de tipo para string match_results.
sregex_iterator Definição de tipo para string regex_iterator.
sregex_token_iterator Definição de tipo para string regex_token_iterator.
ssub_match Definição de tipo para string sub_match.
wcmatch Definição de tipo para wchar_t match_results.
wcregex_iterator Definição de tipo para wchar_t regex_iterator.
wcregex_token_iterator Definição de tipo para wchar_t regex_token_iterator.
wcsub_match Definição de tipo para wchar_t sub_match.
wregex Definição de tipo para wchar_t basic_regex.
wsmatch Definição de tipo para wstring match_results.
wsregex_iterator Definição de tipo para wstring regex_iterator.
wsregex_token_iterator Definição de tipo para wstring regex_token_iterator.
wssub_match Definição de tipo para wstring sub_match.

Funções

Função Descrição
regex_match Corresponde exatamente a uma expressão regular.
regex_replace Substitui expressões regulares correspondentes.
regex_search Pesquisa por uma correspondência de expressão regular.
swap Alterna objetos basic_regex ou match_results.

Operadores

Operador Descrição
operator== Comparação de vários objetos, é igual a.
operator!= Comparação de vários objetos, não é igual a.
operator< Comparação de vários objetos, menor que.
operator\<= Comparação de vários objetos, menor ou igual a.
operator> Comparação de vários objetos, maior que.
operator>= Comparação de vários objetos, maior ou igual a.
operator<< Insere um sub_match em um fluxo.

Confira também

Expressões Regulares (C++)
Classe regex_constants
Classe regex_error
Funções <regex>
Classe regex_iterator
Operadores <regex>
Classe regex_token_iterator
Classe regex_traits
<regex> typedefs