Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::views::all — vue de toute une plage

std::views::all adapte une plage à l’interface des vues tout en conservant tous ses éléments. Le résultat peut être une copie ou un déplacement d’une vue existante, une vue de référence ou une vue propriétaire ; ce choix détermine la gestion de la durée de vie des données.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <ranges>
std::views::all(r)
r | std::views::all

std::views::all, déclaré dans <ranges>, est un objet adaptateur de plage. Les expressions std::views::all(r) et r | std::views::all produisent une vue de tous les éléments, sans filtrer ni transformer leurs valeurs. L’argument doit satisfaire std::ranges::viewable_range.

La sélection suit un ordre fixe : si le type de l’argument, après suppression des références et des qualificatifs, modélise std::ranges::view, le résultat est un objet de ce type, copié ou déplacé selon la catégorie de valeur. Sinon, std::ranges::ref_view est produit s’il peut être construit ; à défaut, c’est std::ranges::owning_view qui est produit. Toutes les vues ne peuvent pas être passées comme l-values : une vue uniquement déplaçable peut nécessiter std::move.

Pour une l-value std::vector<int>, le résultat fait référence au vecteur existant ; pour un std::vector<int> temporaire, il prend possession du vecteur. Un ref_view ne prolonge pas la durée de vie de la source. La source doit rester en vie pendant l’utilisation de la vue, et les règles d’invalidation des itérateurs du conteneur continuent de s’appliquer. Lorsque le vecteur est passé comme l-value, all ne copie pas les éléments. En revanche, passer une vue copiable comme l-value peut entraîner la copie de la vue et des éléments qu’elle stocke : une copie de std::ranges::single_view<int> stocke son propre int.

L’exemple montre les deux cas : une écriture via borrowed modifie values, tandis que owned stocke son propre vecteur. La sortie attendue est constituée de deux lignes contenant chacune 9. Le dépôt utilise l’option C++23 ; la compatibilité d’exécution en production n’est pas attestée.

Exemples

#include <iostream>
#include <ranges>
#include <type_traits>
#include <vector>

int main() {
    std::vector<int> values{1, 2, 3};
    auto borrowed = values | std::views::all;
    auto owned = std::views::all(std::vector<int>{4, 5});

    static_assert(std::is_same_v<decltype(borrowed),
                  std::ranges::ref_view<std::vector<int>>>);
    static_assert(std::is_same_v<decltype(owned),
                  std::ranges::owning_view<std::vector<int>>>);

    borrowed.front() = 9;
    std::cout << values.front() << '\n';

    int sum = 0;
    for (int value : owned) {
        sum += value;
    }
    std::cout << sum << '\n';
}

Résultat

9
9

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.

Sources