Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::ranges::copy — kopiranje elemenata raspona

std::ranges::copy kopira elemente redoslijedom ulaza na odredište određeno izlaznim iteratorom. Prihvaća cijeli raspon ili iterator sa sentinelom te vraća završne položaje ulaza i izlaza.

Verzija: 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 u <algorithm>, dodjeljuje uzastopne ulazne elemente izlazu. Preopterećenja bez pravila izvođenja prihvaćaju raspon ili par iterator–sentinel; sentinel ne mora biti istog tipa kao iterator. Ulaz mora zadovoljavati input_range ili input_iterator, a izlaz mora zadovoljavati weakly_incrementable i odgovarajući zahtjev indirectly_copyable.

Izlaz mora omogućiti zapisivanje svih elemenata. Algoritam ne prima granicu izlaza i sam ne povećava spremnik: kod običnog iteratora odredišni elementi moraju već postojati. Početak izlaza ne smije biti unutar [first, last); kopiranje ulijevo uz preklapanje dopušteno je ako je taj uvjet zadovoljen. Za N elemenata izvršava točno N dodjela.

Rezultat std::ranges::copy_result izlaže .in i .out: završni ulazni iterator i iterator iza posljednjeg zapisanog elementa. Za privremeni raspon koji ne zadovoljava borrowed_range, .in je tipa std::ranges::dangling. Za razliku od std::copy, rezultat nije samo izlazni iterator.

Primjer upotrebljava odvojena polja i preopterećenje koje prima raspon. Ovaj se zapis odnosi na uporabu u C++23; povezani nacrt standarda ažurira se i može sadržavati kasnija proširenja.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori