CKTIS / C++
std::ranges::copy — kopírování prvků rozsahu
std::ranges::copy kopíruje prvky v pořadí vstupu do cíle určeného výstupním iterátorem. Přijímá celý rozsah nebo iterátor se sentinelou a vrací konečné pozice vstupu a výstupu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy deklarovaný v <algorithm> přiřazuje po sobě jdoucí vstupní prvky do výstupu. Přetížení bez zásady provádění přijímají rozsah nebo dvojici iterátor–sentinela; sentinela nemusí mít stejný typ jako iterátor. Vstup musí splňovat input_range nebo input_iterator a výstup musí splňovat weakly_incrementable a odpovídající požadavek indirectly_copyable.
Výstup musí umožňovat zápis všech prvků. Algoritmus nedostává mez výstupu a sám kontejner nezvětšuje: u běžného iterátoru musí cílové prvky již existovat. Začátek výstupu nesmí ležet v [first, last); překrývající se kopírování doleva je dovoleno, pokud je tato podmínka splněna. Pro N prvků provede přesně N přiřazení.
Výsledek std::ranges::copy_result zpřístupňuje .in a .out: konečný vstupní iterátor a iterátor za posledním zapsaným prvkem. U dočasného rozsahu, který nesplňuje borrowed_range, má .in typ std::ranges::dangling. Na rozdíl od std::copy není výsledkem pouze výstupní iterátor.
Příklad používá oddělená pole a přetížení přijímající rozsah. Tento záznam se týká použití v C++23; odkazovaný návrh standardu se aktualizuje a může obsahovat pozdější rozšíření.
Pří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ýsledek
2 4 6 1 1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.