Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::copy: copiar un rango en almacenamiento existente

std::copy asigna cada elemento del rango de entrada a posiciones consecutivas del destino y devuelve el iterador posterior a la última escritura.

Versión: C++23

Sintaxis

template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
                              OutputIterator result);

std::copy(first, last, result), de <algorithm>, avanza en orden y realiza exactamente N asignaciones *out = *in, donde N es el número de elementos de [first, last). Devuelve el iterador avanzado N posiciones desde result; esta descripción del resultado no exige el operador +. Conserva el orden. La copia normal entre objetos separados no modifica el origen, pero un desplazamiento solapado hacia la izquierda puede sobrescribir parte del búfer compartido, y un std::move_iterator puede mover desde el origen.

El destino debe alojar los N elementos; std::copy no amplía un contenedor salvo que reciba un iterador de inserción. En la sobrecarga normal, result no puede estar en [first, last). Para desplazar a la derecha en el mismo búfer usa std::copy_backward.

La sobrecarga con execution policy exige rangos de origen y destino totalmente separados. Una excepción de asignación bajo cualquier política estándar, incluida seq, llama a std::terminate. Un rango vacío no asigna y devuelve result sin cambios.

Ejemplos

#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

Fuentes