База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници