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 );

Перемещает все элементы из исходного диапазона [first, last) в целевой диапазон [d_first, std::next(d_first, std::distance(first, last))).

Параметры

Возвращаемое значение

Итератор за концом целевого диапазона.

Сложность

Ровно std::distance(first, last) присваиваний.

Исключения

• Если требуемые для распараллеливания временные ресурсы памяти недоступны, выбрасывается исключение std::bad_alloc.
• Если при обращении к объектам через аргумент алгоритма выбрасывается необработанное исключение, поведение определяется политикой выполнения (для стандартных политик вызывается std::terminate).

Возможная реализация

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

См. также