std::istreambuf_iterator

template< class CharT, class Traits = std::char_traits<CharT> >
class istreambuf_iterator
    : public std::iterator<std::input_iterator_tag,
                           CharT, typename Traits::off_type,
                           /* unspecified */, CharT>

template< class CharT, class Traits = std::char_traits<CharT> >
class istreambuf_iterator;

std::istreambuf_iterator es un iterador de entrada de un solo paso que lee caracteres sucesivos del objeto std::basic_streambuf para el cual fue construido.

El std::istreambuf_iterator construido por defecto se conoce como el iterador de fin de flujo. Cuando un std::istreambuf_iterator llega al final del flujo subyacente, se vuelve igual al iterador de fin de flujo. Desreferenciarlo o incrementarlo posteriormente invoca un comportamiento indefinido.

Tipos de miembros

El tipo miembro pointer normalmente es CharT* (ver abajo ).

Funciones miembro

Funciones no miembro

Notas

La resolución de LWG issue 659 introdujo operator - > . Se espera que dado un std::istreambuf_iterator i , las expresiones ( * i ) . m y i - > m tengan el mismo efecto.

Sin embargo, la resolución no proporciona una especificación formal de su comportamiento. Por lo tanto, se implementa de manera diferente, incluyendo devolver nullptr , devolver la dirección de un temporal, o incluso no proporcionar el miembro en absoluto. Su comportamiento previsto difícilmente puede lograrse, y se elimina mediante la resolución de LWG issue 2790 .

La resolución de LWG issue 659 también hizo que el tipo miembro pointer no esté especificado para permitir que operator-> devuelva un proxy. Esto permite que operator-> compile cuando CharT no es un tipo clase.

Ejemplo

#include <iostream>
#include <iterator>
#include <sstream>
#include <string>
int main()
{
    // caso de uso típico: un flujo de entrada representado como un par de iteradores
    std::istringstream in{"Hello, world"};
    std::istreambuf_iterator<char> it{in}, end;
    std::string ss{it, end};
    std::cout << "ss tiene " << ss.size() << " bytes; "
                 "contiene \"" << ss << "\"\n";
    // demostración de la naturaleza de paso único
    std::istringstream s{"abc"};
    std::istreambuf_iterator<char> i1{s}, i2{s};
    std::cout << "i1 devuelve '" << *i1 << "'\n"
                 "i2 devuelve '" << *i2 << "'\n";
    ++i1;
    std::cout << "después de incrementar i1, pero no i2:\n"
                 "i1 devuelve '" << *i1 << "'\n"
                 "i2 devuelve '" << *i2 << "'\n";
    ++i2;
    std::cout << "después de incrementar i2, pero no i1:\n"
                 "i1 devuelve '" << *i1 << "'\n"
                 "i2 devuelve '" << *i2 << "'\n";
}

ss tiene 12 bytes; contiene "Hello, world"
i1 devuelve 'a'
i2 devuelve 'a'
después de incrementar i1, pero no i2:
i1 devuelve 'b'
i2 devuelve 'b'
después de incrementar i2, pero no i1:
i1 devuelve 'c'
i2 devuelve 'c'

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

Véase también