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