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

履歴 編集

function template
<algorithm>

std::ranges::move(C++20)

namespace std::ranges {
  template<input_iterator I, sentinel_for<I> S, weakly_incrementable O>
    requires indirectly_movable<I, O>
  constexpr move_result<I, O> move(I first, S last, O result);            // (1)

  template<input_range R, weakly_incrementable O>
    requires indirectly_movable<iterator_t<R>, O>
  constexpr move_result<borrowed_iterator_t<R>, O> move(R&& r, O result); // (2)
}

概要

指定された範囲の要素をムーブする。

  • (1): イテレータペアで範囲を指定する
  • (2): 範囲を直接指定する

事前条件

result[first,last) の範囲に含まれてはならない。

効果

[first,last) 内の要素を、それぞれ [result,result + (last - first)) へムーブする。

ムーブは first から順番に行い、0 以上 last - first 未満であるそれぞれの n について、*(result + n) = std::move(*(first + n)) を行う。

戻り値

move_result {
  .in  = last,
  .out = result + (last - first),
}

計算量

正確に last - first 回ムーブ代入が行われる。

#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
#include <memory>

int main() {
  std::vector<std::unique_ptr<int>> v;
  for (int i = 0; i < 5; i++) {
    v.emplace_back(new int(i));
  }

  std::vector<std::unique_ptr<int>> v2;
  // v のそれぞれの要素を v2 へムーブする
  std::ranges::move(v, std::back_inserter(v2));

  for (const auto& v : v2) {
    std::cout << *v << std::endl;
  }
}

出力

0
1
2
3
4

バージョン

言語

  • C++20

処理系

参照