CKTIS / C++
std::copy: kopírování rozsahu do existující paměti
std::copy přiřadí každý prvek vstupního rozsahu do po sobě jdoucích cílových pozic a vrátí iterátor za posledním zápisem.
Verze: C++23
Syntaxe
template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
OutputIterator result);std::copy(first, last, result) z <algorithm> postupuje v pořadí a provede přesně N přiřazení *out = *in, kde N je počet prvků v [first, last). Vrátí iterátor posunutý o N pozic od result; jde o popis výsledku bez požadavku na operátor +. Pořadí zachová. Běžné kopírování mezi oddělenými objekty zdroj nemění, ale překrývající se posun doleva může přepsat část společného bufferu a std::move_iterator může ze zdroje přesouvat.
Cíl musí pojmout všech N prvků; std::copy kontejner nezvětší, není-li použit vkládací iterátor. U běžného přetížení nesmí result ležet v [first, last). Pro posun doprava ve stejném bufferu použij std::copy_backward.
Přetížení s execution policy vyžaduje zcela nepřekrývající se zdrojový a cílový rozsah. Výjimka z přiřazení pod libovolnou standardní politikou, včetně seq, volá std::terminate. Prázdný rozsah nic nepřiřadí a vrátí nezměněný result.
Pří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ýsledek
4 -1,1,2,3,-1
std::copy → 4 -1,1,2,3,-1