std:: copy_backward

Копирует элементы из диапазона [ first , last ) в другой диапазон, заканчивающийся на d_last . Элементы копируются в обратном порядке (последний элемент копируется первым), но их относительный порядок сохраняется.

Поведение не определено, если d_last находится в диапазоне ( first , last ] . В этом случае необходимо использовать std::copy вместо std::copy_backward .

Параметры

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

Итератор на последний скопированный элемент.

Сложность

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

Примечания

При копировании перекрывающихся диапазонов, std::copy следует использовать при копировании влево (начало целевого диапазона находится вне исходного диапазона), тогда как std::copy_backward следует использовать при копировании вправо (конец целевого диапазона находится вне исходного диапазона).

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

template<class BidirIt1, class BidirIt2>
BidirIt2 copy_backward(BidirIt1 first, BidirIt1 last, BidirIt2 d_last)
{
    while (first != last)
        *(--d_last) = *(--last);
    return d_last;
}

Пример

#include <algorithm>
#include <iostream>
#include <numeric>
#include <vector>
int main()
{
    std::vector<int> source(4);
    std::iota(source.begin(), source.end(), 1); // заполняет значениями 1, 2, 3, 4
    std::vector<int> destination(6);
    std::copy_backward(source.begin(), source.end(), destination.end());
    std::cout << "destination содержит: ";
    for (auto i: destination)
        std::cout << i << ' ';
    std::cout << '\n';
}

destination contains: 0 0 1 2 3 4

Отчеты о дефектах

Следующие отчеты об изменениях в поведении, содержащие описания дефектов, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также