Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri