4. move

最終更新日時(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) C++20

  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) C++20
}

概要

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

事前条件

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

処理系

参照