KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::copy: een bereik naar bestaande opslag kopiëren

std::copy wijst elk element van een invoerbereik toe aan opeenvolgende doelposities en retourneert de iterator na de laatste schrijfactie.

Versie: C++23

Syntax

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

std::copy(first, last, result) uit <algorithm> doorloopt het bereik op volgorde en voert precies N toewijzingen *out = *in uit, waarbij N het aantal elementen in [first, last) is. Het retourneert de iterator die vanaf result N posities is opgeschoven; deze resultaatbeschrijving vereist geen operator +. De volgorde blijft behouden. Gewoon kopiëren tussen gescheiden objecten laat de bron ongewijzigd, maar een overlappende verschuiving naar links kan een deel van de gedeelde buffer overschrijven, en een std::move_iterator kan uit de bron verplaatsen.

Het doel moet alle N elementen kunnen bevatten; std::copy vergroot geen container tenzij een invoegiterator wordt gebruikt. Bij de gewone overload mag result niet in [first, last) liggen. Gebruik std::copy_backward om binnen dezelfde buffer naar rechts te schuiven.

De execution-policy-overload vereist volledig niet-overlappende bron- en doelbereiken. Een toewijzingsexceptie onder elke standaardpolicy, ook seq, roept std::terminate aan. Een leeg bereik wijst niets toe en retourneert result ongewijzigd.

Voorbeelden

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

Resultaat

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

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

Bronnen