std::move

namespace std {
  template <class InputIterator, class OutputIterator>
  OutputIterator
    move(InputIterator first,
         InputIterator last,
         OutputIterator result);   // (1) C++11

  template <class InputIterator, class OutputIterator>
  constexpr OutputIterator
    move(InputIterator first,
         InputIterator last,
         OutputIterator result);   // (1) C++20

  template <class ExecutionPolicy, class ForwardIterator1,
            class ForwardIterator2>
  ForwardIterator2
    move(ExecutionPolicy&& exec,
         ForwardIterator1 first,
         ForwardIterator1 last,
         ForwardIterator2 result); // (2) C++17
}

概要

イテレータ範囲[first, last)の要素を出力イテレータ範囲にムーブする。

事前条件

result はイテレータ範囲[first,last)に含まれてはならない。

効果

イテレータ範囲[first,last) 内の要素を、それぞれ出力イテレータ範囲[result,result + (last - first)) へムーブする。

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

戻り値

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::move(v.begin(), v.end(), std::back_inserter(v2));

  std::for_each(v2.begin(), v2.end(),
    [](const std::unique_ptr<int>& v) { std::cout << *v << std::endl; });
}

 
#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::move(v.begin(), v.end(), std::back_inserter(v2));
​
  std::for_each(v2.begin(), v2.end(),
    [](const std::unique_ptr<int>& v) { std::cout << *v << std::endl; });
}

出力

実装例

template <class InputIterator, class OutputIterator>
OutputIterator move(InputIterator first, InputIterator last, OutputIterator result) {
  while (first != last)
    *result++ = move(*first++);
  return result;
}

Class / Function / Type

Header file

Other / All

std::move

概要

事前条件

効果

戻り値

計算量

例

出力

実装例

バージョン

言語

処理系

関連項目

参照