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.