CKTIS / C++
std::ranges::transform — elementen omzetten naar uitvoer
std::ranges::transform berekent waarden uit één bereik of uit overeenkomstige elementen van twee bereiken en schrijft die via een uitvoeriterator. Het algoritme voert direct uit en is geen luie view.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <algorithm>
std::ranges::transform(r, out, op);
std::ranges::transform(r, out, op, proj);
std::ranges::transform(first, last, out, op, proj);
std::ranges::transform(r1, r2, out, binary_op);
std::ranges::transform(r1, r2, out, binary_op, proj1, proj2);
std::ranges::transform(first1, last1, first2, last2, out, binary_op, proj1, proj2);std::ranges::transform uit <algorithm> accepteert bereiken of iterator-sentinelparen. De unaire vorm zet elk element om; de binaire vorm combineert overeenkomstige elementen en stopt bij het kortste invoerbereik. De optionele projecties proj, proj1, proj2 worden vóór de bewerking toegepast; standaard veranderen ze de argumenten niet.
De uitvoer moet het schrijven van alle resultaten ondersteunen. Het algoritme vergroot een container niet: reserve() alleen maakt geen elementen aan. Zorg voor bestaande elementen of gebruik std::back_inserter met een geschikte container. Omzetten op dezelfde plek is toegestaan wanneer de uitvoer aan het begin van een invoer begint. De bewerking zelf mag de bereikselementen niet wijzigen en iterators niet ongeldig maken.
Het resultaat geeft de eindposities weer als .in en .out, of als .in1, .in2 en .out. Bij een tijdelijk bereik dat geen borrowed range is, kan een invoerveld het type std::ranges::dangling hebben. Bij N geschreven resultaten worden de bewerking en elke projectie precies N keer aangeroepen.
Anders dan de luie view std::views::transform schrijft dit algoritme de resultaten voordat het terugkeert. Dit artikel beschrijft gebruik in C++23; het huidige werkdocument bevat ook latere uitbreidingen. Een compileroptie in de repository bevestigt niet de compatibiliteit met de productie-runtime.
Voorbeelden
#include <algorithm>
#include <array>
#include <iostream>
int main() {
const std::array<int, 4> input{1, 2, 3, 4};
std::array<int, 4> output{};
auto result = std::ranges::transform(
input, output.begin(), [](int x) { return x * x; });
for (auto it = output.begin(); it != result.out; ++it) {
if (it != output.begin()) std::cout << ' ';
std::cout << *it;
}
std::cout << '\n';
}
Resultaat
1 4 9 16
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.