CKTIS / C++
std::transform — elementen van een bereik transformeren
std::transform uit <algorithm> schrijft de resultaten van een unaire of binaire bewerking naar een uitvoerbereik. Het maakt geen container aan en vergroot de grootte ervan niet automatisch.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);std::transform uit <algorithm> verwerkt het halfopen bereik [first1, last1). De unaire vorm past op toe op elk element; de binaire vorm past binary_op toe op overeenkomstige elementen uit twee bereiken. De resultaten worden vanaf result geschreven; de functie retourneert de iterator na het laatst geschreven element.
Bij N elementen in het eerste bereik wordt de bewerking precies N keer aangeroepen. De klassieke binaire vorm krijgt geen einditerator voor het tweede bereik: dat bereik moet ten minste N toegankelijke elementen bevatten. Ook de uitvoer moet N schrijfbewerkingen toelaten. Alleen reserve() aanroepen maakt geen elementen aan; om via begin() te schrijven, moet de container groot genoeg zijn.
Een transformatie op dezelfde plek is toegestaan als result == first1 of, bij de binaire vorm, result == first2. De bewerking zelf mag geen elementen uit de verwerkte bereiken wijzigen en geen iterators ongeldig maken. Vertrouw niet op de volgorde van aanroepen; het eenvoudigst is een resultaat zonder neveneffecten terug te geven.
Het voorbeeld laat beide vormen zien zonder uitvoeringsbeleid. Dit artikel is gericht op C++23; het meegeleverde normontwerp is een levend document en bevat ook latere uitbreidingen die het voorbeeld niet gebruikt.
Voorbeelden
#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';
}
Resultaat
1 4 9 2 6 12
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.