CKTIS / C++
std::ranges::to — construire un conteneur à partir d’une plage
C++23 std::ranges::to construit un objet, généralement un conteneur, à partir d’une plage d’entrée. Il permet de terminer un pipeline de vues par un résultat concret, en indiquant soit le type complet du conteneur, soit un modèle dont les arguments seront déduits.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
std::ranges::to<C>(range, args...)
range | std::ranges::to<C>(args...)
std::ranges::to<ContainerTemplate>(range, args...)
range | std::ranges::to<ContainerTemplate>(args...)std::ranges::to, disponible depuis C++23 dans <ranges>, construit un résultat à partir d’une plage qui satisfait input_range. Pour un conteneur tel que std::vector<int>, la fonction matérialise les éléments au lieu de créer une autre vue paresseuse. Le type destination C doit être un type classe sans qualificatif cv et ne doit pas satisfaire view.
L’expression std::ranges::to<std::vector<int>>(range) spécifie explicitement le type du résultat. La forme std::ranges::to<std::vector>(range) utilise la déduction des arguments de modèle de classe. Dans un pipeline, utilisez range | std::ranges::to<std::vector<int>>() : les () créent un objet de fermeture de pipeline. Les args... supplémentaires, comme un allocateur, sont transmis au constructeur du conteneur sélectionné.
Pour des éléments directement convertibles, la fonction essaie, dans l’ordre : un constructeur acceptant la plage, un constructeur marqué avec std::from_range, un constructeur approprié prenant une paire d’itérateurs, puis la construction avec args... suivie de l’insertion des éléments. Chaque voie a ses propres exigences. Les plages imbriquées peuvent être converties récursivement ; si aucune voie autorisée ne convient, le programme est mal formé.
L’exemple construit un std::vector<int> contenant les carrés de 1 à 5 ; la borne supérieure de std::views::iota(1, 6) est exclue. Matérialiser ce pipeline parcourt ses éléments : n’utilisez donc pas une plage non bornée sans limiter le nombre de ses éléments. Une implémentation de bibliothèque prenant en charge cette fonctionnalité C++23 est nécessaire : le seul indicateur de compilation du dépôt ne garantit pas sa prise en charge en environnement de production. La référence fournie est un projet de norme en évolution, et non une édition C++23 figée.
Exemples
#include <cstddef>
#include <iostream>
#include <ranges>
#include <vector>
int main() {
auto values = std::views::iota(1, 6)
| std::views::transform([](int n) { return n * n; })
| std::ranges::to<std::vector<int>>();
for (std::size_t i = 0; i < values.size(); ++i) {
if (i != 0) std::cout << ' ';
std::cout << values[i];
}
std::cout << '\n';
}
Résultat
1 4 9 16 25
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.