CKTIS / C++
std::ranges::copy — copier les éléments d’une plage
std::ranges::copy copie les éléments dans leur ordre d’entrée vers une destination indiquée par un itérateur de sortie. Il accepte une plage entière ou un itérateur et une sentinelle, puis renvoie les positions finales d’entrée et de sortie.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy, déclaré dans <algorithm>, affecte les éléments d’entrée successifs à la sortie. Les surcharges sans politique d’exécution acceptent une plage ou une paire itérateur-sentinelle ; la sentinelle n’a pas besoin d’avoir le même type que l’itérateur. L’entrée doit satisfaire input_range ou input_iterator, et la sortie doit satisfaire weakly_incrementable ainsi que l’exigence correspondante indirectly_copyable.
La sortie doit permettre l’écriture de chaque élément. L’algorithme ne reçoit aucune limite de sortie et n’agrandit pas lui-même un conteneur : avec un itérateur ordinaire, les éléments de destination doivent déjà exister. Le début de la sortie ne doit pas se trouver dans [first, last) ; une copie avec chevauchement vers la gauche est autorisée si cette condition est respectée. Pour N éléments, il effectue exactement N affectations.
Le résultat std::ranges::copy_result expose .in et .out : l’itérateur d’entrée final et l’itérateur situé après le dernier élément écrit. Pour une plage temporaire qui ne satisfait pas borrowed_range, .in est de type std::ranges::dangling. Contrairement à std::copy, le résultat n’est pas simplement un itérateur de sortie.
L’exemple utilise des tableaux distincts et la surcharge prenant une plage. Cette fiche concerne l’utilisation en C++23 ; le brouillon de norme lié est mis à jour et peut contenir des extensions ultérieures.
Exemples
#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';
}
Résultat
2 4 6 1 1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.