cppdraft_translate/cppdraft/range/to/input/iterator.md

[range.to.input.iterator]

25 Ranges library [ranges]

25.7 Range adaptors [range.adaptors]

25.7.35 To input view [range.to.input]

25.7.35.3 Class template to_input_view​::​iterator [range.to.input.iterator]

🔗

namespace std::ranges {template<input_range V>requires viewtemplateclass to_input_view::iterator {using Base = maybe-const<Const, V>; // exposition only iterator_t<Base> current_ = iterator_t<Base>(); // exposition onlyconstexpr explicit iterator(iterator_t<Base> current); // exposition onlypublic:using difference_type = range_difference_t<Base>; using value_type = range_value_t<Base>; using iterator_concept = input_iterator_tag; iterator() requires default_initializable<iterator_t<Base>> = default; iterator(iterator&&) = default; iterator& operator=(iterator&&) = default; constexpr iterator(iterator i)requires Const && convertible_to<iterator_t, iterator_t<Base>>; constexpr iterator_t<Base> base() &&; constexpr const iterator_t<Base>& base() const & noexcept; constexpr decltype(auto) operator*() const { return **current_*; }constexpr iterator& operator++(); constexpr void operator++(int); friend constexpr bool operator==(const iterator& x, const sentinel_t<Base>& y); friend constexpr difference_type operator-(const sentinel_t<Base>& y, const iterator& x)requires sized_sentinel_for<sentinel_t<Base>, iterator_t<Base>>; friend constexpr difference_type operator-(const iterator& x, const sentinel_t<Base>& y)requires sized_sentinel_for<sentinel_t<Base>, iterator_t<Base>>; friend constexpr range_rvalue_reference_t<Base> iter_move(const iterator& i)noexcept(noexcept(ranges::iter_move(i.current_))); friend constexpr void iter_swap(const iterator& x, const iterator& y)noexcept(noexcept(ranges::iter_swap(x.current_, y.current_)))requires indirectly_swappable<iterator_t<Base>>; };}

🔗

constexpr explicit iterator(iterator_t<Base> current);

1

#

Effects: Initializes current_ with std​::​move(current).

🔗

constexpr iterator(iterator<!Const> i) requires Const && [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_­to [concept.convertible]")<iterator_t<V>, iterator_t<Base>>;

2

#

Effects: Initializes current_ with std​::​move(i.current_).

🔗

constexpr iterator_t<Base> base() &&;

3

#

Returns: std​::​move(current_).

🔗

constexpr const iterator_t<Base>& base() const & noexcept;

4

#

Returns: current_.

🔗

constexpr iterator& operator++();

5

#

Effects: Equivalent to:++current_;return *this;

🔗

constexpr void operator++(int);

6

#

Effects: Equivalent to: ++*this;

🔗

friend constexpr bool operator==(const iterator& x, const sentinel_t<Base>& y);

7

#

Returns: x.current_ == y.

🔗

friend constexpr difference_type operator-(const sentinel_t<Base>& y, const iterator& x) requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_­sentinel_­for [iterator.concept.sizedsentinel]")<sentinel_t<Base>, iterator_t<Base>>;

8

#

Returns: y - x.current_.

🔗

friend constexpr difference_type operator-(const iterator& x, const sentinel_t<Base>& y) requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_­sentinel_­for [iterator.concept.sizedsentinel]")<sentinel_t<Base>, iterator_t<Base>>;

9

#

Returns: x.current_ - y.

🔗

friend constexpr range_rvalue_reference_t<Base> iter_move(const iterator& i) noexcept(noexcept(ranges::iter_move(i.current_)));

10

#

Effects: Equivalent to: return ranges​::​iter_move(i.current_);

🔗

friend constexpr void iter_swap(const iterator& x, const iterator& y) noexcept(noexcept(ranges::iter_swap(x.current_, y.current_))) requires [indirectly_swappable](alg.req.ind.swap#concept:indirectly_swappable "24.3.7.4 Concept indirectly_­swappable [alg.req.ind.swap]")<iterator_t<Base>>;

11

#

Effects: Equivalent to: ranges​::​iter_swap(x.current_, y.current_);