Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje