std::move

From Cppreference

Moves the elements in the range [first, last), to another range beginning at d_first.

[edit] Parameters

[edit] Return value

Output iterator to the element past the last element moved (d_first + (last - first))

[edit] Complexity

Exactly last - first move assignments.

[edit] Equivalent function

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

[edit] Example

The following code moves threads handles (which themselves are not copyable) from one container to another.

#include <iostream>
#include <vector>
#include <list>
#include <iterator>
#include <thread>
#include <chrono>
 
void f(int n)
{
    std::this_thread::sleep_for(std::chrono::seconds(n));
    std::cout << "thread " << n << " ended" << '\n';
}
 
int main()
{
    std::vector<std::thread> v;
    v.emplace_back(f, 1);
    v.emplace_back(f, 2);
    v.emplace_back(f, 3);
    std::list<std::thread> l;
 
    // copy() would not compile
    std::move(v.begin(), v.end(), std::back_inserter(l)); 
 
    for(auto& t : l) t.join();
}

Output:

thread 1 ended
thread 2 ended
thread 3 ended

[edit] See also