最終更新日時(UTC):
が更新

履歴 編集

function
<iterator>

std::iter_swap(C++20)

namespace std {
  template <class Iterator>
  class move_iterator {

    template<indirectly_swappable<Iterator> Iterator2>
    friend constexpr void
      iter_swap(const move_iterator& x, const move_iterator<Iterator2>& y)
        noexcept(noexcept(ranges::iter_swap(x.current, y.current)));
  };
}

概要

move_iteratorであるx, yの指す要素を交換する。

効果

以下と等価

ranges::iter_swap(x.current, y.current);

戻り値

return move_iterator<Iterator>(std::move(i));

備考

この関数はmove_iteratorのクラス定義内でfriend関数として定義される。そのため、メンバ関数としても非メンバ関数としても明示的に呼び出すことはできず、ADLによってのみ呼び出すことができる。 基本的にはranges::iter_swapカスタマイゼーションポイントオブジェクトを通して利用する。

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

int main() {
  std::vector<int> v1 = {1, 2, 3, 4, 5};
  std::vector<int> v2 = {6, 7, 8, 9, 10};

  std::move_iterator<decltype(v2)::iterator> it1(v1.begin());
  std::move_iterator<decltype(v1)::iterator> it2(v2.begin());

  // ADLによる呼び出し
  iter_swap(it1, it2);

  ++it1;
  ++it2;

  // ranges::iter_swap CPOによる呼び出し
  std::ranges::iter_swap(it1, it2);

  for (int n : v1) {
    std::cout << n << ' ';
  }

  std::cout << '\n';

  for (int n : v2) {
    std::cout << n << ' ';
  }
}

出力

6 7 3 4 5 
1 2 8 9 10 

バージョン

言語

  • C++20

処理系

関連項目

  • ranges::iter_swap

参照