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 659 добавило operator->. Предполагается, что для std::istreambuf_iterator i выражения (*i).m и i->m имеют одинаковый эффект.

Однако это решение не содержит формальной спецификации поведения. Поэтому реализация различается: в частности, оператор может возвращать nullptr, возвращать адрес временного объекта или вообще не предоставлять этот член. Предполагаемое поведение практически невозможно обеспечить, и этот оператор был удалён решением вопроса LWG 2790.

Решение вопроса LWG 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++.

См. также