Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła