CKTIS / C++
std::copy: copiar um intervalo para armazenamento existente
std::copy atribui cada elemento do intervalo de entrada a posições consecutivas do destino e devolve o iterador após a última escrita.
Versão: C++23
Sintaxe
template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
OutputIterator result);std::copy(first, last, result), de <algorithm>, avança por ordem e realiza exatamente N atribuições *out = *in, sendo N o número de elementos em [first, last). Devolve o iterador avançado N posições a partir de result; esta descrição do resultado não exige o operador +. Preserva a ordem. A cópia normal entre objetos separados não altera a origem, mas um deslocamento sobreposto para a esquerda pode sobrescrever parte do buffer partilhado, e um std::move_iterator pode mover a partir da origem.
O destino tem de comportar os N elementos; std::copy não aumenta um contentor, exceto com um iterador de inserção. Na sobrecarga normal, result não pode estar em [first, last). Para deslocar à direita no mesmo buffer usa std::copy_backward.
A sobrecarga com execution policy exige intervalos de origem e destino totalmente separados. Uma exceção de atribuição sob qualquer política padrão, incluindo seq, chama std::terminate. Um intervalo vazio não atribui e devolve result inalterado.
Exemplos
#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main() {
const std::vector<int> source{1, 2, 3};
std::vector<int> destination(5, -1);
const auto end = std::copy(source.begin(), source.end(), destination.begin() + 1);
std::cout << std::distance(destination.begin(), end) << ' ';
for (std::size_t i = 0; i < destination.size(); ++i) {
if (i != 0) std::cout << ',';
std::cout << destination[i];
}
std::cout << '\n';
}
Resultado
4 -1,1,2,3,-1
std::copy → 4 -1,1,2,3,-1