iter_move.md

iter_move (非メンバ関数)

• iterator[meta header]
• std[meta namespace]
• basic_const_iterator[meta class]
• function[meta id-type]
• cpp23[meta cpp]

friend constexpr rvalue-reference iter_move(const basic_const_iterator& i) noexcept(/*see below*/);

概要

basic_const_iteratorであるiの指す要素をムーブする。

戻り値のrvalue-referenceは次のように求められるconstかつ右辺値となる型である

using rvalue-reference = common_reference_t<const iter_value_t<Iterator>&&, iter_rvalue_reference_t<Iterator>>;

戻り値

ラップしているイテレータをcurrent_メンバ変数に保持するとして、次のようになる

return static_cast<rvalue-reference>(ranges::iter_move(i.current_));

• ranges::iter_move[link /reference/iterator/iter_move.md]

例外

noexcept指定には次の式が指定される

noexcept(static_cast<rvalue-reference>(ranges::iter_move(i.current_)))

備考

この関数はHidden friendsとして定義される。

例

#include <iterator>
#include <vector>
#include <iostream>

int main() {
  std::vector vec = {1, 2, 3, 4, 5};

  std::basic_const_iterator cit = vec.begin();

  // ADLによる呼び出し
  int n1 = iter_move(cit);
  std::cout << n1 << std::endl;
  
  ++cit;

  // ranges::iter_move CPOによる呼び出し
  int n2 = std::ranges::iter_move(cit);
  std::cout << n2 << std::endl;
}

• iter_move[color ff0000]
• ranges::iter_move[link /reference/iterator/iter_move.md]

出力

1
2

バージョン

言語

• C++23

処理系

• Clang: ??
• GCC: 13.1 [mark verified]
• Visual C++: 2022 Update 6 [mark verified]

参照

• P2278R4 cbegin should always return a constant iterator