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.