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

CKTIS / C++

std::ranges::transform — transformer des éléments vers une sortie

std::ranges::transform calcule des valeurs à partir d’une plage ou d’éléments correspondants de deux plages, puis les écrit au moyen d’un itérateur de sortie. C’est un algorithme immédiat, et non une vue paresseuse.

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

Syntaxe

#include <algorithm>
std::ranges::transform(r, out, op);
std::ranges::transform(r, out, op, proj);
std::ranges::transform(first, last, out, op, proj);
std::ranges::transform(r1, r2, out, binary_op);
std::ranges::transform(r1, r2, out, binary_op, proj1, proj2);
std::ranges::transform(first1, last1, first2, last2, out, binary_op, proj1, proj2);

std::ranges::transform de <algorithm> accepte des plages ou des paires itérateur-sentinelle. La forme unaire transforme chaque élément ; la forme binaire combine les éléments correspondants et s’arrête à la plage d’entrée la plus courte. Les projections facultatives proj, proj1, proj2 sont appliquées avant l’opération ; par défaut, elles ne modifient pas les arguments.

La sortie doit permettre l’écriture de tous les résultats. L’algorithme n’agrandit pas un conteneur : reserve() seul ne crée pas d’éléments. Fournissez des éléments existants ou utilisez std::back_inserter avec un conteneur adapté. La transformation sur place est autorisée lorsque la sortie commence au début d’une entrée. L’opération elle-même ne doit ni modifier les éléments des plages ni invalider les itérateurs.

Le résultat expose les positions finales sous la forme .in et .out, ou .in1, .in2 et .out. Pour une plage temporaire qui n’est pas une plage empruntable, un champ d’entrée peut être de type std::ranges::dangling. Pour N résultats écrits, l’opération et chaque projection sont appelées exactement N fois.

Contrairement à la vue paresseuse std::views::transform, cet algorithme écrit les résultats avant de renvoyer. Cette entrée décrit l’utilisation en C++23 ; le projet de travail actuel contient aussi des extensions ultérieures. Un indicateur de compilateur dans le dépôt ne garantit pas la compatibilité de l’environnement d’exécution de production.

Exemples

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    const std::array<int, 4> input{1, 2, 3, 4};
    std::array<int, 4> output{};

    auto result = std::ranges::transform(
        input, output.begin(), [](int x) { return x * x; });

    for (auto it = output.begin(); it != result.out; ++it) {
        if (it != output.begin()) std::cout << ' ';
        std::cout << *it;
    }
    std::cout << '\n';
}

Résultat

1 4 9 16

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