Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::ranges::copy — kopírovanie prvkov rozsahu

std::ranges::copy kopíruje prvky v poradí vstupu do cieľa určeného výstupným iterátorom. Prijíma celý rozsah alebo iterátor so sentinelom a vracia konečné pozície vstupu a výstupu.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);

std::ranges::copy deklarovaný v <algorithm> priraďuje po sebe idúce vstupné prvky do výstupu. Preťaženia bez politiky vykonávania prijímajú rozsah alebo dvojicu iterátor–sentinel; sentinel nemusí mať rovnaký typ ako iterátor. Vstup musí spĺňať input_range alebo input_iterator a výstup musí spĺňať weakly_incrementable a príslušnú požiadavku indirectly_copyable.

Výstup musí umožňovať zápis všetkých prvkov. Algoritmus nedostáva hranicu výstupu a sám nezväčšuje kontajner: pri bežnom iterátore musia cieľové prvky už existovať. Začiatok výstupu nesmie ležať v [first, last); prekrývajúce sa kopírovanie doľava je povolené, ak je táto podmienka splnená. Pre N prvkov vykoná presne N priradení.

Výsledok std::ranges::copy_result sprístupňuje .in a .out: konečný vstupný iterátor a iterátor za posledným zapísaným prvkom. Pri dočasnom rozsahu, ktorý nespĺňa borrowed_range, má .in typ std::ranges::dangling. Na rozdiel od std::copy výsledkom nie je iba výstupný iterátor.

Príklad používa samostatné polia a preťaženie prijímajúce rozsah. Tento záznam sa týka používania v C++23; odkazovaný návrh štandardu sa aktualizuje a môže obsahovať neskoršie rozšírenia.

Príklady

#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';
}

Výsledok

2 4 6
1 1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje