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 <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 << ' ';
}
}
31
#include <iterator>#include <vector>#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による呼び出し出力
6 7 3 4 5
1 2 8 9 10
バージョン
言語
- C++20
処理系
- Clang: ??
- GCC: 10.1 ✅
- Visual C++: 2019 Update 7 ✅