iter_move(std::counted_iterator) - cppreference.com (original) (raw)

Casts the result of dereferencing the underlying iterator to its associated rvalue reference type.

The function body is equivalent to return ranges::iter_move(i.base());.

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

If i.count() is equal to ​0​, the behavior is undefined.

[edit] Parameters

[edit] Return value

An rvalue reference or a prvalue temporary.

[edit] Complexity

Constant.

[edit] Example

#include #include #include #include #include   void print(auto const& rem, auto const& v) { std::cout << rem << '[' << size(v) << "] {"; for (char comma[]{0, ' ', 0}; auto const& s : v) std::cout << comma << std::quoted(s), comma = ','; std::cout << "}\n"; }   int main() { std::vector<std::string> p{"Alpha", "Bravo", "Charlie"}, q; print("p", p); print("q", q);   using RI = std::counted_iterator<std::vector<std::string>::iterator>;   for (RI iter{p.begin(), 2}; iter != std::default_sentinel; ++iter) q.emplace_back(/ ADL */ iter_move(iter));   print("p", p); print("q", q); }

Possible output:

p[3] {"Alpha", "Bravo", "Charlie"} q[0] {} p[3] {"", "", "Charlie"} q[2] {"Alpha", "Bravo"}

[edit] Defect reports

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

[edit] See also