std::move

template< class InputIt, class OutputIt >
OutputIt move( InputIt first, InputIt last,
               OutputIt d_first );

template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2 >
ForwardIt2 move( ExecutionPolicy&& policy,
                 ForwardIt1 first, ForwardIt1 last,
                 ForwardIt2 d_first );

만약 d_first가 범위 [first, last) 내에 있으면, 동작은 정의되지 않습니다. 이 경우, std::move_backward를 대신 사용할 수 있습니다.

매개변수

반환값

마지막으로 이동된 요소 바로 다음 요소를 가리키는 반복자입니다.

복잡도

정확히 std::distance(first, last) 번의 이동 할당이 수행됩니다.

예외

템플릿 매개변수 이름이 ExecutionPolicy인 오버로드는 다음과 같이 오류를 보고합니다:

• 알고리즘의 일부로 호출된 함수의 실행이 예외를 던지고 ExecutionPolicy이(가) 표준 정책 중 하나이면, std::terminate이(가) 호출됩니다. 다른 ExecutionPolicy의 경우, 동작은 구현 정의입니다.
• 알고리즘이 메모리 할당에 실패하면, std::bad_alloc이(가) 던져집니다.

가능한 구현

template<class InputIt, class OutputIt>
OutputIt move(InputIt first, InputIt last, OutputIt d_first)
{
    for (; first != last; ++d_first, ++first)
        *d_first = std::move(*first);
    
    return d_first;
}

참고

겹치는 범위를 이동할 때, std::move는 왼쪽으로 이동할 때 적합하며 (대상 범위의 시작이 소스 범위 밖에 있음), std::move_backward는 오른쪽으로 이동할 때 적합합니다 (대상 범위의 끝이 소스 범위 밖에 있음).

예제

다음 코드는 스레드 객체(자체적으로 복사 불가능)를 한 컨테이너에서 다른 컨테이너로 이동합니다.

#include <algorithm>
#include <chrono>
#include <iostream>
#include <iterator>
#include <list>
#include <thread>
#include <vector>

void f(int n)
{
    std::this_thread::sleep_for(std::chrono::seconds(n));
    std::cout << "thread " << n << " ended" << std::endl;
}

int main()
{
    std::vector<std::jthread> v;
    v.emplace_back(f, 1);
    v.emplace_back(f, 2);
    v.emplace_back(f, 3);
    std::list<std::jthread> l;
    
    // copy() would not compile, because std::jthread is noncopyable
    std::move(v.begin(), v.end(), std::back_inserter(l));
}

thread 1 ended
thread 2 ended
thread 3 ended

참고 항목