CKTIS / C++
std::ranges::copy — копиране на елементи от диапазон
std::ranges::copy копира елементите в реда на входа към цел, зададена чрез изходен итератор. Приема цял диапазон или итератор и сентинел и връща крайните позиции на входа и изхода.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy, деклариран в <algorithm>, присвоява последователните входни елементи към изхода. Претоварванията без политика за изпълнение приемат диапазон или двойка итератор–сентинел; сентинелът не е задължително да е от същия тип като итератора. Входът трябва да удовлетворява input_range или input_iterator, а изходът — weakly_incrementable и съответното изискване indirectly_copyable.
Изходът трябва да позволява записването на всички елементи. Алгоритъмът не получава граница на изхода и сам не увеличава контейнер: при обикновен итератор целевите елементи трябва вече да съществуват. Началото на изхода не трябва да е в [first, last); копиране наляво с припокриване е позволено, ако това условие е изпълнено. За N елемента алгоритъмът извършва точно N присвоявания.
Резултатът std::ranges::copy_result предоставя .in и .out: крайния входен итератор и итератора след последния записан елемент. При временен диапазон, който не удовлетворява borrowed_range, .in е от тип std::ranges::dangling. За разлика от std::copy, резултатът не е само изходен итератор.
Примерът използва отделни масиви и претоварването, което приема диапазон. Този материал разглежда употребата в C++23; свързаният проект на стандарт се обновява и може да съдържа по-късни разширения.
Примери
#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';
}
Резултат
2 4 6 1 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.