Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::copy: copiare un intervallo in memoria esistente

std::copy assegna ogni elemento dell’intervallo di input a posizioni consecutive di destinazione e restituisce l’iteratore dopo l’ultima scrittura.

Versione: C++23

Sintassi

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

std::copy(first, last, result) di <algorithm> procede in ordine ed esegue esattamente N assegnamenti *out = *in, dove N è il numero di elementi in [first, last). Restituisce l’iteratore avanzato di N posizioni da result; questa descrizione del risultato non richiede l’operatore +. Mantiene l’ordine. La copia ordinaria tra oggetti disgiunti lascia invariata la sorgente, ma uno spostamento sovrapposto a sinistra può sovrascrivere parte del buffer condiviso, e un std::move_iterator può spostare dalla sorgente.

La destinazione deve contenere tutti gli N elementi; std::copy non amplia un contenitore, salvo l’uso di un iteratore di inserimento. Nell’overload ordinario result non può trovarsi in [first, last). Per spostare a destra nello stesso buffer usa std::copy_backward.

L’overload con execution policy richiede intervalli sorgente e destinazione completamente disgiunti. Un’eccezione di assegnamento con qualsiasi policy standard, inclusa seq, chiama std::terminate. Un intervallo vuoto non assegna e restituisce result invariato.

Esempi

#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';
}

Risultato

4 -1,1,2,3,-1

std::copy → 4 -1,1,2,3,-1

Fonti