SysTutorials

Linux Manual Pages › Section 3

stdexperimentalrangesoutputiterator(3)

std::experimental::ranges::OutputIterator - std::experimental::ranges::OutputIterator

Synopsis

Defined in header <experimental/ranges/iterator>
template <class I, class T>
concept bool OutputIterator =
Iterator<I> && Writable<I, T> &&                                      (ranges TS)
requires(I i, T&& t) {
    *i++ = std::forward<T>(t); // not required to be equality preserving
};

The OutputIterator concept is a refinement of Iterator, adding the requirement that it can be used to write values of values of type and value category encoded by T (via Writable). EqualityComparable is not required. Let E be an expression such that decltype((E)) is T, and i be a dereferenceable object of type I. OutputIterator<I, T> is satisfied only if *i++ = E; has effects equivalent to *i = E; ++i;. Equality preservation An expression is equality preserving if it results in equal outputs given equal inputs.

Notes

Unlike the output iterator requirements in the C++ standard, OutputIterator in the Ranges TS does not require that the iterator category tag be defined. Algorithms on output iterators should be single pass.