CKTIS / C++
std::ranges::copy — kopiowanie elementów zakresu
std::ranges::copy kopiuje elementy w kolejności wejściowej do miejsca wskazanego iteratorem wyjściowym. Przyjmuje cały zakres albo iterator i wartownika oraz zwraca końcowe pozycje wejścia i wyjścia.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy z nagłówka <algorithm> przypisuje kolejne elementy wejściowe do wyjścia. Warianty bez polityki wykonania przyjmują zakres albo parę iterator–wartownik; wartownik nie musi mieć typu iteratora. Wejście musi spełniać input_range lub input_iterator, a wyjście — weakly_incrementable i odpowiednie wymaganie indirectly_copyable.
Wyjście musi umożliwiać zapis wszystkich elementów. Algorytm nie otrzymuje granicy wyjścia i sam nie powiększa kontenera: zwykły iterator wymaga istniejących elementów docelowych. Początek wyjścia nie może leżeć w [first, last); kopiowanie w lewo z nakładaniem jest dozwolone, jeśli ten warunek jest spełniony. Wykonuje dokładnie N przypisań dla N elementów.
Wynik std::ranges::copy_result udostępnia .in i .out: końcowy iterator wejścia oraz iterator za ostatnim zapisanym elementem. Dla tymczasowego zakresu niespełniającego borrowed_range pole .in ma typ std::ranges::dangling. W przeciwieństwie do std::copy wynik nie jest samym iteratorem wyjścia.
Przykład używa osobnych tablic i wariantu zakresowego. Wpis dotyczy użycia w C++23; podlinkowany szkic standardu jest aktualizowany i może zawierać późniejsze rozszerzenia.
Przykłady
#include <algorithm>
#include <array>
#include <iostream>
int main() {
const std::array<int, 3> source{2, 4, 6};
std::array<int, 3> destination{};
const auto result = std::ranges::copy(source, destination.begin());
std::cout << destination[0] << ' ' << destination[1] << ' '
<< destination[2] << '\n';
std::cout << (result.in == source.end()) << ' '
<< (result.out == destination.end()) << '\n';
}
Wynik
2 4 6 1 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.