regex_iterator (Clase)

Clase de iterador para las coincidencias.

Sintaxis

template<class BidIt,
   class Elem = typename std::iterator_traits<BidIt>::value_type,
   class RxTraits = regex_traits<Elem> >
class regex_iterator

Parámetros

BidIt
El tipo de iterador para subcoincidencias.

Elem
Tipo de los elementos que debe coincidir.

RXtraits
Clase Traits para los elementos.

Comentarios

La plantilla de clase describe un objeto constante de iterador hacia delante. Extrae objetos de tipo match_results<BidIt> aplicando varias veces su propio objeto de expresión regular *pregex a la secuencia de caracteres definida por el rango de iterador [begin, end).

Constructores

Constructor	Descripción
regex_iterator	Construye el iterador.

Typedefs

Nombre de tipo	Descripción
difference_type	El tipo de diferencia de un iterador.
iterator_category	Tipo de la categoría del iterador.
pointer	El tipo de un puntero a una coincidencia.
referencia	El tipo de una referencia a una coincidencia.
regex_type	El tipo de expresión regular que debe coincidir.
value_type	Tipo de una coincidencia.

Operadores

Operador	Descripción
operator!=	Compara iteradores para buscar desigualdad.
operator*	Tiene acceso a la coincidencia designada.
operator++	Incrementa el iterador almacenado.
operator=	Compara iteradores para buscar igualdad.
operator->	Tiene acceso a la coincidencia designada.

Requisitos

Encabezado:<regex>

Espacio de nombres: std

Ejemplos

Para obtener ejemplos de expresiones regulares, vea los artículos siguientes:

• regex_match

• regex_replace

• regex_search

• swap

// std__regex__regex_iterator.cpp
// compile with: /EHsc
#include <regex>
#include <iostream>

typedef std::regex_iterator<const char *> Myiter;
int main()
    {
    const char *pat = "axayaz";
    Myiter::regex_type rx("a");
    Myiter next(pat, pat + strlen(pat), rx);
    Myiter end;

    for (; next != end; ++next)
        std::cout << "match == " << next->str() << std::endl;

// other members
    Myiter it1(pat, pat + strlen(pat), rx);
    Myiter it2(it1);
    next = it1;

    Myiter::iterator_category cat = std::forward_iterator_tag();
    Myiter::difference_type dif = -3;
    Myiter::value_type mr = *it1;
    Myiter::reference ref = mr;
    Myiter::pointer ptr = &ref;

    dif = dif; // to quiet "unused" warnings
    ptr = ptr;

    return (0);
    }

match == a
match == a
match == a

regex_iterator::d ifference_type

El tipo de diferencia de un iterador.

typedef std::ptrdiff_t difference_type;

Comentarios

El tipo es un sinónimo de std::ptrdiff_t.

regex_iterator::iterator_category

Tipo de la categoría del iterador.

typedef std::forward_iterator_tag iterator_category;

Comentarios

El tipo es un sinónimo de std::forward_iterator_tag.

regex_iterator::operator!=

Compara iteradores para buscar desigualdad.

bool operator!=(const regex_iterator& right);

Parámetros

right
Iterador con el que se compara.

Comentarios

La función miembro devuelve !(*this == right).

regex_iterator::operator*

Tiene acceso a la coincidencia designada.

const match_results<BidIt>& operator*();

Comentarios

La función miembro devuelve el valor almacenado match.

regex_iterator::operator++

Incrementa el iterador almacenado.

regex_iterator& operator++();
regex_iterator& operator++(int);

Comentarios

Si la coincidencia actual no tiene ningún carácter, el primer operador llama a regex_search(begin, end, match, *pregex, flags | regex_constants::match_prev_avail | regex_constants::match_not_null); de lo contrario, pasa el valor almacenado begin para señalar el primer carácter después de la coincidencia actual y luego llama a regex_search(begin, end, match, *pregex, flags | regex_constants::match_prev_avail). En cualquiera de los casos, si se produce un error en la búsqueda, el operador establece el objeto en un iterador de final de la secuencia. El operador devuelve el objeto.

El segundo operador realiza una copia del objeto, incrementa el objeto y devuelve la copia.

regex_iterator::operator=

Compara iteradores para buscar igualdad.

bool operator==(const regex_iterator& right);

Parámetros

right
Iterador con el que se compara.

Comentarios

La función miembro devuelve true si *this y right son los iteradores de final de secuencia o si ninguno es un iterador de final de secuencia y begin == right.begin, end == right.end, pregex == right.pregex y flags == right.flags. De lo contrario, devuelve false.

regex_iterator::operator->

Tiene acceso a la coincidencia designada.

const match_results<BidIt> * operator->();

Comentarios

La función miembro devuelve la dirección del valor almacenado match.

regex_iterator::p ointer

El tipo de un puntero a una coincidencia.

typedef match_results<BidIt> *pointer;

Comentarios

El tipo es un sinónimo de match_results<BidIt>*, donde BidIt es el parámetro de plantilla.

regex_iterator::reference

El tipo de una referencia a una coincidencia.

typedef match_results<BidIt>& reference;

Comentarios

El tipo es un sinónimo de match_results<BidIt>&, donde BidIt es el parámetro de plantilla.

regex_iterator::regex_iterator

Construye el iterador.

regex_iterator();

regex_iterator(BidIt first,
    BidIt last,
    const regex_type& re,
    regex_constants::match_flag_type f = regex_constants::match_default);

Parámetros

first
Principio de la secuencia que debe coincidir.

last
Final de la secuencia que debe coincidir.

re
Expresión regular para las coincidencias.

f
Marcadores para coincidencias.

Comentarios

El primer constructor crea un iterador de final de secuencia. El segundo constructor inicializa el valor almacenado begin con first, el valor almacenado end con last, el valor almacenado pregex con &re, y el valor almacenado flags con f. A continuación, llama a regex_search(begin, end, match, *pregex, flags). Si se produce un error en la búsqueda, el constructor establece el objeto en un iterador de final de secuencia.

regex_iterator::regex_type

El tipo de expresión regular que debe coincidir.

typedef basic_regex<Elem, RXtraits> regex_type;

Comentarios

La definición de tipo es un sinónimo de basic_regex<Elem, RXtraits>.

regex_iterator::value_type

Tipo de una coincidencia.

typedef match_results<BidIt> value_type;

Comentarios

El tipo es un sinónimo de match_results<BidIt>, donde BidIt es el parámetro de plantilla.

Consulte también

<regex>
regex_constants (Clase)
regex_error (Clase)
<regex> functions
regex_iterator (Clase)
<regex> operators
regex_token_iterator (Clase)
regex_traits (Clase)
<regex> typedefs