CKTIS / C++
std::ranges::copy — kopiranje elementov območja
std::ranges::copy kopira elemente po vrstnem redu vhoda na cilj, določen z izhodnim iteratorjem. Sprejme celotno območje ali iterator s sentinelom ter vrne končni mesti vhoda in izhoda.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy, deklariran v <algorithm>, zaporedne vhodne elemente prireja izhodu. Preobremenitve brez izvedbene politike sprejmejo območje ali par iterator–sentinel; sentinel ni nujno istega tipa kot iterator. Vhod mora izpolnjevati input_range ali input_iterator, izhod pa weakly_incrementable in ustrezno zahtevo indirectly_copyable.
Izhod mora omogočati zapis vseh elementov. Algoritem ne prejme meje izhoda in vsebnika ne poveča sam: pri običajnem iteratorju morajo ciljni elementi že obstajati. Začetek izhoda ne sme biti znotraj [first, last); prekrivajoče kopiranje v levo je dovoljeno, če je ta pogoj izpolnjen. Za N elementov izvede natanko N prirejanj.
Rezultat std::ranges::copy_result omogoča dostop do .in in .out: do končnega vhodnega iteratorja in iteratorja za zadnjim zapisanim elementom. Pri začasnem območju, ki ne izpolnjuje borrowed_range, je .in tipa std::ranges::dangling. Za razliko od std::copy rezultat ni zgolj izhodni iterator.
Primer uporablja ločeni polji in preobremenitev, ki sprejme območje. Ta zapis obravnava uporabo v C++23; povezani osnutek standarda se posodablja in lahko vsebuje poznejše razširitve.
Primeri
#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';
}
Rezultat
2 4 6 1 1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.