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 — это итератор поточного ввода, который считывает последовательные символы из объекта std::basic_streambuf, для которого он был сконструирован.

Итератор std::istreambuf_iterator, сконструированный по умолчанию, известен как итератор конца потока. Когда допустимый итератор std::istreambuf_iterator достигает конца базового потока, он становится равен итератору конца потока. Обращение к нему или дальнейшее его инкрементирование приводит к неопределённому поведению.

Типы-члены

Тип-член pointer обычно равен CharT* (см. ниже).

Члены-функции

Функции, не являющиеся членами

Примечания

Решение проблемы LWG issue 659 ввело оператор ->. Ожидается, что при заданном std::istreambuf_iterator i, выражения (*i).m и i->m имеют одинаковый эффект.

Однако решение не предоставляет формального описания его поведения. Таким образом, его реализация может отличаться, включая возврат nullptr, возврат адреса временной переменной или даже полное отсутствие этого члена. Его предполагаемое поведение сложно достичь, и оно было удалено в решении LWG issue 2790.

Решение LWG issue 659 также сделало тип-член pointer не определённым, чтобы разрешить operator-> возвращать прокси. Это позволяет operator-> компилироваться, когда CharT не является типом класса.

Пример

#include <iostream>
#include <iterator>
#include <sstream>
#include <string>
 
int main()
{
    // typical use case: an input stream represented as a pair of iterators
    std::istringstream in{"Hello, world"};
    std::istreambuf_iterator<char> it{in}, end;
    std::string ss{it, end};
    std::cout << "ss has " << ss.size() << " bytes; "
                 "it holds \"" << ss << "\"\n";
 
    // demonstration of the single-pass nature
    std::istringstream s{"abc"};
    std::istreambuf_iterator<char> i1{s}, i2{s};
    std::cout << "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
 
    ++i1;
    std::cout << "after incrementing i1, but not i2:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
 
    ++i2;
    std::cout << "after incrementing i2, but not i1:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
}

ss has 12 bytes; it holds "Hello, world"
i1 returns 'a'
i2 returns 'a'
after incrementing i1, but not i2:
i1 returns 'b'
i2 returns 'b'
after incrementing i2, but not i1:
i1 returns 'c'
i2 returns 'c'

Отчёты об ошибках

Следующие отчёты об ошибках, меняющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также