KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen