CKTIS / C++
std::copy: kopírovanie rozsahu do existujúcej pamäte
std::copy priradí každý prvok vstupného rozsahu do po sebe idúcich cieľových pozícií a vráti iterátor za posledným zápisom.
Verzia: C++23
Syntax
template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
OutputIterator result);std::copy(first, last, result) z <algorithm> postupuje v poradí a vykoná presne N priradení *out = *in, kde N je počet prvkov v [first, last). Vráti iterátor posunutý o N pozícií od result; ide o opis výsledku bez požiadavky na operátor +. Poradie zachová. Bežné kopírovanie medzi oddelenými objektmi zdroj nemení, ale prekrývajúci sa posun doľava môže prepísať časť spoločného buffera a std::move_iterator môže zo zdroja presúvať.
Cieľ musí pojať všetkých N prvkov; std::copy kontajner nezväčší, ak sa nepoužije vkladací iterátor. Pri bežnom preťažení nesmie result ležať v [first, last). Na posun doprava v rovnakom bufferi použi std::copy_backward.
Preťaženie s execution policy vyžaduje úplne neprekrývajúce sa zdrojové a cieľové rozsahy. Výnimka z priradenia pod ľubovoľnou štandardnou politikou vrátane seq volá std::terminate. Prázdny rozsah nič nepriradí a vráti nezmenený result.
Príklady
#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';
}
Výsledok
4 -1,1,2,3,-1
std::copy → 4 -1,1,2,3,-1