CKTIS / C++
std::views::transform — luie transformatie van een bereik
std::views::transform maakt een view die het resultaat van een functie voor een element pas berekent wanneer dat element wordt benaderd. Er wordt geen resultaatcontainer gemaakt; gebruik de view rechtstreeks of in een pijplijn met de operator |.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::views::transform(range, callable)
range | std::views::transform(callable)std::views::transform, gedeclareerd in <ranges>, is een range-adapter die een std::ranges::transform_view maakt. Zowel std::views::transform(range, callable) als range | std::views::transform(callable) biedt getransformeerde elementen in de volgorde van de bron aan, zonder ze te filteren.
De evaluatie is lui: de functie wordt aangeroepen wanneer een iterator wordt gedereferentieerd, niet wanneer de view wordt gemaakt. Resultaten worden niet gecachet, dus herhaald benaderen kan de functie opnieuw aanroepen. De view zelf maakt geen resultaatcontainer en overschrijft de bron niet automatisch. De functie kan wel een referentie in plaats van een waarde teruggeven.
De functie moet voor de elementreferentie voldoen aan regular_invocable: gelijkwaardige argumenten horen gelijkwaardige resultaten op te leveren, zonder de argumenten of de eigen toestand van het functieobject te wijzigen. Het resultaat mag niet van het type void zijn. Vermijd daarom aanroeptellers en muterende lambda’s als transformatiefuncties.
Bij een container die als lvalue wordt doorgegeven, verwijst de view naar die container: deze moet in leven blijven zolang de view wordt gebruikt. Ook referenties die de functie vastlegt, moeten geldig blijven. Een iterator is bovendien afhankelijk van het view-object; bewaar hem niet nadat de view is vernietigd.
Het voorbeeld wijzigt numbers[0] nadat doubled is gemaakt. Het resultaat 8 4 6 laat zien dat de view de actuele elementen leest in plaats van een eerder berekende kopie op te slaan. Gebruik de compilatiemodus -std=c++23; de verstrekte bronnen zijn een doorlopend bijgewerkt normontwerp, geen vastgelegde C++23-tekst.
Voorbeelden
#include <array>
#include <iostream>
#include <ranges>
int main() {
std::array<int, 3> numbers{1, 2, 3};
auto doubled = numbers | std::views::transform([](int n) {
return n * 2;
});
numbers[0] = 4;
bool first = true;
for (int value : doubled) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Resultaat
8 4 6
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.