Compartilhar via


Classe regex_token_iterator

A classe do iterador para submatches.

template<class BidIt, class Elem = iterator_traits<BidIt>::value_type,
    class RXtraits = regex_traits<Elem> >
        class regex_token_iterator {
public:
    typedef basic_regex<Elem, RXtraits> regex_type;
    typedef sub_match<BidIt> value_type;
    typedef std::forward_iterator_tag iterator_category;
    typedef std::ptrdiff_t difference_type;
    typedef const sub_match<BidIt> *pointer;
    typedef const sub_match<BidIt>& reference;

    regex_token_iterator();
    regex_token_iterator(BidIt first, BidIt last,
        const regex_type& re, int submatch = 0,
        regex_constants::match_flag_type f = regex_constants::match_default);
    regex_token_iterator(BidIt first, BidIt last,
        const regex_type& re, const std::vector<int> submatches,
        regex_constants::match_flag_type f = regex_constants::match_default);
    template<std::size_t N>
    regex_token_iterator(BidIt first, BidIt last,
        const regex_type& re, const int (&submatches)[N],
        regex_constants::match_flag_type f = regex_constants::match_default);

    bool operator==(const regex_token_iterator& right);
    bool operator!=(const regex_token_iterator& right);
    const basic_string<Elem>& operator*();
    const basic_string<Elem> *operator->();
    regex_token_iterator& operator++();
    regex_token_iterator& operator++(int);
private:
    regex_iterator<BidIt, Elem, RXtraits> it; // exposition only
    vector<int> subs;                         // exposition only
    int pos;                                  // exposition only
    };

Parâmetros

  • BidIt
    O tipo de iterador para submatches.

  • Elem
    O tipo de elementos a ser comparado.

  • RXtraits
    Classe de características para os elementos.

Comentários

A classe do modelo descreve um objeto para frente constante de iterador. Conceitualmente, mantém um objeto de regex_iterator que usa o para pesquisar por correspondência da expressão regular em uma sequência de caracteres. Extrai os objetos do tipo sub_match<BidIt> que representam os submatches identificados pelos valores de índice no vetor armazenado subs para cada correspondência da expressão regular.

Um valor de índice de -1 designa o início da sequência de caracteres imediatamente após o fim da correspondência anterior à expressão regular, ou o início no início da sequência de caracteres se não havia nenhuma correspondência anterior à expressão regular, e a extensão mas não incluir o primeiro caractere da correspondência atual da expressão regular, ou ao término da sequência de caracteres se não houver nenhuma correspondência atual. Qualquer outro valor de índice idx designa o conteúdo do grupo de captura realizado em it.match[idx].

Requisitos

regex <deCabeçalho: >

Namespace: std

Consulte também

Referência

<regex>

Classe regex_token_iterator

Classe regex_iterator

Outros recursos

<regex> Membros