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.