CKTIS / C++
std::views::join — aplatissement différé de plages
std::views::join crée une vue différée des éléments d’une plage de plages. Elle aplatit un niveau, conserve l’ordre et ignore les plages internes vides sans construire de nouveau conteneur.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::views::join(r)
r | std::views::joinstd::views::join, déclaré dans <ranges>, est un adaptateur de plage qui crée une std::ranges::join_view. Écrire r | std::views::join revient à appeler std::views::join(r). La plage externe et ses plages internes doivent permettre au minimum une lecture séquentielle conforme à input_range.
La vue aplatit exactement un niveau : elle parcourt les éléments des plages internes successives et ignore les plages vides. Elle n’insère pas de séparateurs et ne crée pas de conteneur résultat. Dans l’exemple, c’est la boucle qui affiche les espaces, pas l’adaptateur.
Pour un conteneur passé comme l-value, la vue fait référence aux données existantes. Le conteneur doit rester en vie pendant l’utilisation de la vue ; évitez les modifications qui invalident les itérateurs. Lorsque le déréférencement produit une référence modifiable, écrire via cette référence modifie l’élément source.
Ne supposez ni un accès aléatoire ni la disponibilité de size(), même si la source utilise des vecteurs. La catégorie de l’itérateur dépend des plages et de la manière dont leurs éléments sont exposés ; join_view fournit au mieux une itération bidirectionnelle. Le projet de travail cité est mis à jour au fil du temps et ne constitue pas une spécification C++23 figée.
Exemples
#include <iostream>
#include <ranges>
#include <vector>
int main() {
std::vector<std::vector<int>> rows{{1, 2}, {}, {3, 4}};
auto flat = rows | std::views::join;
bool first = true;
for (int value : flat) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Résultat
1 2 3 4
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.