Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::transform — przekształcanie elementów zakresu

std::transform z <algorithm> zapisuje wyniki operacji jednoargumentowej lub dwuargumentowej do zakresu wyjściowego. Nie tworzy kontenera ani nie zwiększa automatycznie jego rozmiaru.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);

std::transform z <algorithm> przetwarza zakres półotwarty [first1, last1). Wariant jednoargumentowy stosuje op do każdego elementu; wariant dwuargumentowy stosuje binary_op do odpowiadających sobie elementów dwóch zakresów. Wyniki zapisuje od result, a zwraca iterator za ostatnim zapisanym elementem.

Dla N elementów pierwszego zakresu wykonuje dokładnie N wywołań operacji. Klasyczny wariant dwuargumentowy nie przyjmuje końca drugiego zakresu: musi on zawierać co najmniej N dostępnych elementów. Wyjście także musi umożliwiać N zapisów. Samo reserve() nie tworzy elementów; przed zapisem przez begin() potrzebny jest odpowiedni rozmiar kontenera.

Przekształcanie w miejscu jest dozwolone, gdy result == first1 lub, w wariancie dwuargumentowym, result == first2. Sama funkcja operacji nie może modyfikować elementów przetwarzanych zakresów ani unieważniać iteratorów. Nie polegaj na kolejności jej wywołań; najprościej zwracać wynik bez efektów ubocznych.

Przykład pokazuje oba warianty bez polityki wykonania. Zakres wpisu to C++23; podany projekt standardu jest dokumentem rozwijanym i zawiera także późniejsze rozszerzenia, których przykład nie używa.

Przykłady

#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';
}

Wynik

1 4 9
2 6 12

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła