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

CKTIS / C++

std::transform — transformer les éléments d’une plage

std::transform de <algorithm> écrit les résultats d’une opération unaire ou binaire dans une plage de sortie. Il ne crée pas de conteneur et n’en augmente pas automatiquement la taille.

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

Syntaxe

#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);

std::transform de <algorithm> traite la plage semi-ouverte [first1, last1). La forme unaire applique op à chaque élément ; la forme binaire applique binary_op aux éléments correspondants de deux plages. Les résultats sont écrits à partir de result, et la fonction renvoie l’itérateur situé après le dernier élément écrit.

Pour N éléments dans la première plage, l’opération est appelée exactement N fois. La forme binaire classique ne reçoit pas d’itérateur de fin pour la deuxième plage : celle-ci doit contenir au moins N éléments accessibles. La sortie doit également permettre N écritures. Appeler seulement reserve() ne crée pas d’éléments ; pour écrire via begin(), le conteneur doit avoir une taille suffisante.

La transformation sur place est autorisée lorsque result == first1 ou, pour la forme binaire, result == first2. L’opération elle-même ne doit ni modifier les éléments des plages traitées ni invalider des itérateurs. Ne vous fiez pas à l’ordre de ses appels ; le plus simple est de renvoyer un résultat sans effet de bord.

L’exemple présente les deux formes sans politique d’exécution. Cette entrée concerne C++23 ; le projet de norme fourni est un document évolutif qui contient aussi des ajouts ultérieurs non utilisés dans l’exemple.

Exemples

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

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

    std::transform(input.begin(), input.end(), squared.begin(),
                   [](int x) { return x * x; });
    std::transform(input.begin(), input.end(), squared.begin(), sums.begin(),
                   [](int x, int y) { return x + y; });

    std::cout << squared[0] << ' ' << squared[1] << ' ' << squared[2] << '\n';
    std::cout << sums[0] << ' ' << sums[1] << ' ' << sums[2] << '\n';
}

Résultat

1 4 9
2 6 12

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