WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::copy: einen Bereich in vorhandenen Speicher kopieren

std::copy weist jedes Element eines Eingabebereichs aufeinanderfolgenden Zielpositionen zu und liefert den Iterator hinter dem letzten Schreibvorgang.

Version: C++23

Syntax

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

std::copy(first, last, result) aus <algorithm> läuft der Reihe nach von first bis last und führt genau N Zuweisungen *out = *in aus, wobei N die Elementzahl in [first, last) ist. Es liefert den um N Positionen ab result weitergesetzten Iterator; diese Ergebnisbeschreibung verlangt keinen Operator +. Die Reihenfolge bleibt erhalten. Normales Kopieren zwischen getrennten Objekten lässt die Quelle unverändert, doch eine überlappende Verschiebung nach links kann Teile des gemeinsamen Puffers überschreiben, und ein std::move_iterator kann aus der Quelle verschieben.

Das Ziel muss alle N Elemente aufnehmen; std::copy vergrößert keinen Container, außer ein Einfügeiterator wird benutzt. Beim normalen Overload darf result nicht in [first, last) liegen. Zum Verschieben nach rechts im selben Puffer dient std::copy_backward.

Der Execution-Policy-Overload verlangt vollständig getrennte Quell- und Zielbereiche. Eine Ausnahme aus der Zuweisung unter jeder Standard-Policy, auch seq, ruft std::terminate auf. Ein leerer Bereich weist nichts zu und liefert result unverändert.

Beispiele

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

Ergebnis

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

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

Quellen