CKTIS / C++
std::ranges::transform — przekształcanie elementów do wyjścia
std::ranges::transform oblicza wartości dla jednego zakresu lub par elementów dwóch zakresów i zapisuje je przez iterator wyjściowy. To algorytm wykonujący pracę od razu, a nie leniwy widok.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 z <algorithm> przyjmuje zakresy albo pary iterator–wartownik. Wariant jednoargumentowy przekształca każdy element; dwuargumentowy łączy odpowiadające sobie elementy i kończy na krótszym wejściu. Opcjonalne projekcje proj, proj1, proj2 są stosowane przed operacją; domyślnie nie zmieniają argumentów.
Wyjście musi umożliwiać zapis wszystkich wyników. Algorytm nie powiększa kontenera: samo reserve() nie tworzy elementów. Zapewnij istniejące elementy albo użyj std::back_inserter z odpowiednim kontenerem. Przekształcanie w miejscu jest dozwolone, gdy wyjście zaczyna się na początku wejścia. Sama operacja nie może modyfikować elementów zakresów ani unieważniać iteratorów.
Wynik udostępnia końcowe pozycje jako .in i .out albo .in1, .in2 i .out. Dla tymczasowego zakresu niebędącego zakresem pożyczonym pole wejściowe może mieć typ std::ranges::dangling. Dla N zapisanych wyników operacja i każda projekcja są wywoływane dokładnie N razy.
W odróżnieniu od leniwego std::views::transform algorytm zapisuje wyniki przed powrotem. Wpis opisuje użycie w C++23; bieżący szkic standardu zawiera także późniejsze rozszerzenia. Flaga kompilatora w repozytorium nie potwierdza zgodności środowiska produkcyjnego.
Przykłady
#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';
}
Wynik
1 4 9 16
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.