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

CKTIS / C++

std::views::transform — transformation paresseuse d’une plage

std::views::transform crée une vue qui calcule le résultat d’une fonction pour un élément uniquement lorsque celui-ci est consulté. Elle ne crée pas de conteneur de résultats ; utilisez-la directement ou dans un pipeline avec l’opérateur |.

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

Syntaxe

#include <ranges>
std::views::transform(range, callable)
range | std::views::transform(callable)

std::views::transform, déclaré dans <ranges>, est un adaptateur de plage qui crée une std::ranges::transform_view. Les formes std::views::transform(range, callable) et range | std::views::transform(callable) exposent toutes deux les éléments transformés dans l’ordre de la source, sans les filtrer.

L’évaluation est paresseuse : la fonction est appelée lors du déréférencement d’un itérateur, et non lors de la construction de la vue. Les résultats ne sont pas mis en cache ; un accès répété peut donc rappeler la fonction. La vue elle-même ne crée pas de conteneur de résultats et ne remplace pas automatiquement la source. La fonction peut toutefois renvoyer une référence plutôt qu’une valeur.

La fonction doit satisfaire regular_invocable pour la référence à l’élément : des arguments équivalents doivent produire des résultats équivalents, sans modifier les arguments ni l’état propre de l’objet fonction. Le résultat ne peut pas être de type void. Évitez donc les compteurs d’appels et les lambdas mutantes comme fonctions de transformation.

Pour un conteneur passé comme lvalue, la vue fait référence à ce conteneur : celui-ci doit rester vivant pendant l’utilisation de la vue. Les références capturées par la fonction doivent également rester valides. Un itérateur dépend en outre de l’objet vue ; ne le conservez pas après la destruction de la vue.

L’exemple modifie numbers[0] après la création de doubled. Le résultat 8 4 6 montre que la vue lit les éléments actuels au lieu de stocker une copie calculée auparavant. Utilisez le mode de compilation -std=c++23 ; les sources fournies sont un projet de norme évolutif, et non un texte C++23 figé.

Exemples

#include <array>
#include <iostream>
#include <ranges>

int main() {
    std::array<int, 3> numbers{1, 2, 3};
    auto doubled = numbers | std::views::transform([](int n) {
        return n * 2;
    });

    numbers[0] = 4;
    bool first = true;
    for (int value : doubled) {
        if (!first) std::cout << ' ';
        std::cout << value;
        first = false;
    }
    std::cout << '\n';
}

Résultat

8 4 6

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