Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes