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 issue 2790 .

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

Пример

#include <iostream>
#include <iterator>
#include <sstream>
#include <string>
int main()
{
    // типичный случай использования: входной поток, представленный в виде пары итераторов
    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";
    // демонстрация однопроходной природы
    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++.

Смотрите также