CKTIS / C++
std::copy: kopiranje obsega v obstoječo shrambo
std::copy priredi vsak element vhodnega obsega zaporednim ciljnim mestom in vrne iterator za zadnjim zapisom.
Različica: C++23
Sintaksa
template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
OutputIterator result);std::copy(first, last, result) iz <algorithm> gre po vrsti in izvede natanko N prireditev *out = *in, kjer je N število elementov v [first, last). Vrne iterator, pomaknjen za N mest od result; to je opis rezultata brez zahteve po operatorju +. Vrstni red ohrani. Navadno kopiranje med ločenimi objekti vira ne spremeni, prekrivajoči se pomik levo pa lahko prepiše del skupnega medpomnilnika, std::move_iterator pa lahko iz vira premika.
Cilj mora sprejeti vseh N elementov; std::copy vsebnika ne poveča, razen z vstavljalnim iteratorjem. Pri navadni preobremenitvi result ne sme biti v [first, last). Za pomik desno v istem medpomnilniku uporabi std::copy_backward.
Preobremenitev z execution policy zahteva povsem neprekrivna izvorni in ciljni obseg. Izjema pri prireditvi pod katerokoli standardno politiko, tudi seq, pokliče std::terminate. Prazen obseg ne priredi ničesar in vrne nespremenjen result.
Primeri
#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';
}
Rezultat
4 -1,1,2,3,-1
std::copy → 4 -1,1,2,3,-1