Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ranges::copy — kopiowanie elementów zakresu

std::ranges::copy kopiuje elementy w kolejności wejściowej do miejsca wskazanego iteratorem wyjściowym. Przyjmuje cały zakres albo iterator i wartownika oraz zwraca końcowe pozycje wejścia i wyjścia.

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

Składnia

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

std::ranges::copy z nagłówka <algorithm> przypisuje kolejne elementy wejściowe do wyjścia. Warianty bez polityki wykonania przyjmują zakres albo parę iterator–wartownik; wartownik nie musi mieć typu iteratora. Wejście musi spełniać input_range lub input_iterator, a wyjście — weakly_incrementable i odpowiednie wymaganie indirectly_copyable.

Wyjście musi umożliwiać zapis wszystkich elementów. Algorytm nie otrzymuje granicy wyjścia i sam nie powiększa kontenera: zwykły iterator wymaga istniejących elementów docelowych. Początek wyjścia nie może leżeć w [first, last); kopiowanie w lewo z nakładaniem jest dozwolone, jeśli ten warunek jest spełniony. Wykonuje dokładnie N przypisań dla N elementów.

Wynik std::ranges::copy_result udostępnia .in i .out: końcowy iterator wejścia oraz iterator za ostatnim zapisanym elementem. Dla tymczasowego zakresu niespełniającego borrowed_range pole .in ma typ std::ranges::dangling. W przeciwieństwie do std::copy wynik nie jest samym iteratorem wyjścia.

Przykład używa osobnych tablic i wariantu zakresowego. Wpis dotyczy użycia w C++23; podlinkowany szkic standardu jest aktualizowany i może zawierać późniejsze rozszerzenia.

Przykłady

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

Wynik

2 4 6
1 1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła