KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ranges::copy — elementen van een bereik kopiëren

std::ranges::copy kopieert elementen in invoervolgorde naar een bestemming die door een uitvoeriterator wordt aangegeven. De functie accepteert een volledig bereik of een iterator met sentinel en geeft de uiteindelijke invoer- en uitvoerposities terug.

Versie: 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, gedeclareerd in <algorithm>, kent opeenvolgende invoerelementen toe aan de uitvoer. Overloads zonder uitvoeringsbeleid accepteren een bereik of een iterator-sentinel-paar; de sentinel hoeft niet hetzelfde type te hebben als de iterator. De invoer moet voldoen aan input_range of input_iterator, en de uitvoer aan weakly_incrementable en de bijbehorende eis indirectly_copyable.

De uitvoer moet het schrijven van alle elementen toestaan. Het algoritme krijgt geen uitvoergrens en vergroot een container niet zelf: bij een gewone iterator moeten de bestemmingselementen al bestaan. Het begin van de uitvoer mag niet binnen [first, last) liggen; overlappend kopiëren naar links is toegestaan als aan deze voorwaarde wordt voldaan. Voor N elementen voert het precies N toewijzingen uit.

Het resultaat std::ranges::copy_result biedt .in en .out: de uiteindelijke invoeriterator en de iterator na het laatst geschreven element. Voor een tijdelijke range die niet aan borrowed_range voldoet, heeft .in het type std::ranges::dangling. Anders dan bij std::copy bestaat het resultaat niet alleen uit een uitvoeriterator.

Het voorbeeld gebruikt afzonderlijke arrays en de overload met een range. Dit artikel behandelt gebruik in C++23; de gelinkte ontwerpversie van de C++-standaard wordt bijgewerkt en kan latere uitbreidingen bevatten.

Voorbeelden

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

Resultaat

2 4 6
1 1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen