3.1 KiB
[istreambuf.iterator.general]
24 Iterators library [iterators]
24.6 Stream iterators [stream.iterators]
24.6.4 Class template istreambuf_iterator [istreambuf.iterator]
24.6.4.1 General [istreambuf.iterator.general]
The class templateistreambuf_iterator defines an input iterator that reads successivecharacters from the streambuf for which it was constructed.
operator* provides access to the current input character, if any.
Each timeoperator++ is evaluated, the iterator advances to the next input character.
If the end of stream is reached (streambuf_type::sgetc() returnstraits::eof()), the iterator becomes equal to theend-of-stream iterator value.
The default constructoristreambuf_iterator() and the constructoristreambuf_iterator(nullptr) both construct an end-of-stream iterator object suitable for use as an end-of-range.
All specializations of istreambuf_iterator shall have a trivial copy constructor, a constexpr default constructor, and a trivial destructor.
The result ofoperator*() on an end-of-stream iterator is undefined.
For any other iterator value achar_type value is returned.
It is impossible to assign a character via an input iterator.
namespace std {template<class charT, class traits = char_traits>class istreambuf_iterator {public:using iterator_category = input_iterator_tag; using value_type = charT; using difference_type = typename traits::off_type; using pointer = unspecified; using reference = charT; using char_type = charT; using traits_type = traits; using int_type = typename traits::int_type; using streambuf_type = basic_streambuf<charT,traits>; using istream_type = basic_istream<charT,traits>; // [istreambuf.iterator.proxy], class istreambuf_iterator::proxyclass proxy; // exposition onlyconstexpr istreambuf_iterator() noexcept; constexpr istreambuf_iterator(default_sentinel_t) noexcept; istreambuf_iterator(const istreambuf_iterator&) noexcept = default; ~istreambuf_iterator() = default; istreambuf_iterator(istream_type& s) noexcept; istreambuf_iterator(streambuf_type* s) noexcept; istreambuf_iterator(const proxy& p) noexcept; istreambuf_iterator& operator=(const istreambuf_iterator&) noexcept = default; charT operator*() const; istreambuf_iterator& operator++(); proxy operator++(int); bool equal(const istreambuf_iterator& b) const; friend bool operator==(const istreambuf_iterator& i, default_sentinel_t s); private: streambuf_type* sbuf_; // exposition only};}