CKTIS / C++
std::ranges::copy — Elemente eines Bereichs kopieren
std::ranges::copy kopiert Elemente in Eingabereihenfolge an ein durch einen Ausgabeiterator bestimmtes Ziel. Der Algorithmus akzeptiert einen ganzen Bereich oder einen Iterator mit Sentinel und gibt die endgültigen Positionen für Eingabe und Ausgabe zurück.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy aus <algorithm> weist aufeinanderfolgende Eingabeelemente der Ausgabe zu. Überladungen ohne Ausführungsrichtlinie akzeptieren einen Bereich oder ein Iterator-Sentinel-Paar; der Sentinel muss nicht denselben Typ wie der Iterator haben. Die Eingabe muss input_range oder input_iterator erfüllen, die Ausgabe weakly_incrementable und die entsprechende Anforderung indirectly_copyable.
Die Ausgabe muss das Schreiben aller Elemente ermöglichen. Der Algorithmus erhält keine Ausgabegrenze und vergrößert einen Container nicht selbst: Bei einem gewöhnlichen Iterator müssen die Zielelemente bereits vorhanden sein. Der Ausgabestart darf nicht in [first, last) liegen; überlappendes Kopieren nach links ist zulässig, wenn diese Bedingung erfüllt ist. Für N Elemente führt der Algorithmus genau N Zuweisungen aus.
Das Ergebnis std::ranges::copy_result stellt .in und .out bereit: den endgültigen Eingabeiterator und den Iterator hinter dem zuletzt geschriebenen Element. Bei einem temporären Bereich, der borrowed_range nicht erfüllt, hat .in den Typ std::ranges::dangling. Anders als bei std::copy besteht das Ergebnis nicht nur aus einem Ausgabeiterator.
Das Beispiel verwendet getrennte Arrays und die Bereichsüberladung. Dieser Eintrag behandelt die Verwendung in C++23; der verlinkte Standardentwurf wird aktualisiert und kann spätere Erweiterungen enthalten.
Beispiele
#include <algorithm>
#include <array>
#include <iostream>
int main() {
const std::array<int, 3> source{2, 4, 6};
std::array<int, 3> destination{};
const auto result = std::ranges::copy(source, destination.begin());
std::cout << destination[0] << ' ' << destination[1] << ' '
<< destination[2] << '\n';
std::cout << (result.in == source.end()) << ' '
<< (result.out == destination.end()) << '\n';
}
Ergebnis
2 4 6 1 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.