Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri