Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

iter_move(std::basic_const_iterator<Iter>)

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

Iterator
  • C++20
  • C++23
1 min readView on cppreference
NotebookLM
friend constexpr /*rvalue-reference*/
    iter_move( const basic_const_iterator& i ) noexcept(/* see below */);
(since C++23)

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

The return type /*rvalue-reference*/ is std::common_reference_t<const std::iter_value_t<Iter>&&, std::iter_rvalue_reference_t<Iter>>.

The function body is equivalent to
return static_cast</*rvalue-reference*/>(std::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::basic_const_iterator<Iter> is an associated class of the arguments.

Parameter

i - a basic_const_iterator

Return value

An rvalue reference to const, or a prvalue.

Exceptions

noexcept specification:  
noexcept(noexcept(static_cast</*rvalue-reference*/>(std::ranges::iter_move(i.base()))))

Example

This section is incomplete
Reason: no example

See also

(C++20)
casts the result of dereferencing an object to its associated rvalue reference type
(customization point object)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.