std::copy_backward

template< class BidirIt1, class BidirIt2 >
BidirIt2 copy_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );

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

Если d_last находится в (first, last], поведение не определено.

Параметры

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

Итератор на последний скопированный элемент диапазона назначения или d_last, если ни один элемент не был скопирован.

Сложность

Ровно 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); // fills with 1, 2, 3, 4
    
    std::vector<int> destination(6);
    
    std::copy_backward(source.begin(), source.end(), destination.end());
    
    std::cout << "destination contains: ";
    for (auto i: destination)
        std::cout << i << ' ';
    std::cout << '\n';
}

destination contains: 0 0 1 2 3 4

Отчёты об ошибках

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

См. также