Ranges library
Range access
Range conversions

Range primitives

Dangling iterator handling
Range concepts

Range factories
Range adaptors
Range generators
Range adaptor objects
Range adaptor closure objects
Helper items
(until C++23)(C++23)

struct /*iterator*/;
(since C++20)
(exposition only*)

The return type of basic_istream_view::begin.

/*iterator*/ is an input_iterator, but does not satisfy LegacyInputIterator, and thus does not work with pre-C++20 algorithms.


[edit] Member types

Member type Definition
iterator_concept (C++20) std::input_iterator_tag
difference_type (C++20) std::ptrdiff_t
value_type (C++20) Val

[edit] Member functions

constructs an iterator
(public member function)
the copy assignment operator is deleted; /*iterator*/ is move-only
(public member function)
advances the iterator
(public member function)
returns the current element
(public member function)


constexpr explicit /*iterator*/( basic_istream_view& parent );
(1) (since C++20)
/*iterator*/( const /*iterator*/& ) = delete;
(2) (since C++20)
/*iterator*/( /*iterator*/&& ) = default;
(3) (since C++20)
1) Constructs an iterator from the parent basic_istream_view.
2) The copy constructor is deleted. The iterator is not copyable.
3) The move constructor is defaulted. The iterator is movable.


/*iterator*/& operator=( const /*iterator*/& ) = delete;
(1) (since C++20)
/*iterator*/& operator=( /*iterator*/&& ) = default;
(2) (since C++20)
1) The copy assignment operator is deleted. The iterator is not copyable.
2) The move assignment operator is defaulted. The iterator is movable.


/*iterator*/& operator++();
(1) (since C++20)
void operator++(int);
(2) (since C++20)

Reads a value from the underlying stream and stores it into the parent basic_istream_view.

Return value

1) *this
2) (none)


Val& operator*() const;
(since C++20)

Returns a reference to the stored value.

[edit] Non-member functions

compares with a std::default_sentinel_t
(public member function)

operator==(std::ranges::basic_istream_view::iterator, std::default_sentinel)

friend bool operator==( const /*iterator*/& x, std::default_sentinel_t );
(since C++20)

Compares an iterator with std::default_sentinel_t.

Returns true if *this does not have a parent basic_istream_view, or if an error has occurred on the underlying stream.

This function is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::ranges::basic_istream_view::iterator is an associated class of the arguments.

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
P2325R3 C++20 default constructor was provided as C++20 iterators
must be default_initializable
removed along with the requirement