Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::copy: kopiowanie zakresu do istniejącego celu

std::copy przypisuje każdy element zakresu wejściowego do kolejnych pozycji celu i zwraca iterator za ostatnim zapisanym elementem.

Wersja: C++23

Składnia

template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
                              OutputIterator result);

std::copy(first, last, result) z <algorithm> przechodzi od first do last i wykonuje w kolejności dokładnie N przypisań *out = *in, gdzie N jest liczbą elementów w [first, last). Zwraca iterator przesunięty o N pozycji od result; jest to opis wyniku, bez wymogu obsługi operatora +. Algorytm zachowuje kolejność. Przy zwykłym kopiowaniu między rozłącznymi obiektami źródło pozostaje bez zmian, lecz nakładające się przesunięcie w lewo może nadpisać część wspólnego bufora, a std::move_iterator może przenosić ze źródła.

Miejsce docelowe musi mieścić wszystkie N elementów; std::copy nie powiększa kontenera, chyba że podano iterator wstawiający. Dla zwykłego przeciążenia result nie może leżeć w [first, last). Przy przesuwaniu w prawo w tym samym buforze użyj std::copy_backward.

Przeciążenie z execution policy wymaga całkowicie niepokrywających się zakresów źródła i celu. Wyjątek z przypisania pod standardową polityką wykonania, także seq, prowadzi do std::terminate. Pusty zakres nie wykonuje przypisań i zwraca niezmienione result.

Przykłady

#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';
}

Wynik

4 -1,1,2,3,-1

std::copy → 4 -1,1,2,3,-1

Źródła