Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::transform — transformace prvků rozsahu

std::transform z <algorithm> zapisuje výsledky unární nebo binární operace do výstupního rozsahu. Nevytváří kontejner ani automaticky nezvětšuje jeho velikost.

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

Syntaxe

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

std::transform z <algorithm> zpracovává polootevřený rozsah [first1, last1). Unární forma aplikuje op na každý prvek; binární forma aplikuje binary_op na odpovídající prvky dvou rozsahů. Výsledky zapisuje od result a vrací iterátor za posledním zapsaným prvkem.

Pro N prvků v prvním rozsahu provede přesně N volání operace. Klasická binární forma nepřijímá koncový iterátor druhého rozsahu: ten musí obsahovat alespoň N přístupných prvků. Výstup musí rovněž umožňovat N zápisů. Samotné zavolání reserve() prvky nevytvoří; pro zápis přes begin() musí mít kontejner dostatečnou velikost.

Transformace na místě je povolena, když platí result == first1 nebo u binární formy result == first2. Samotná operace nesmí měnit prvky zpracovávaných rozsahů ani zneplatňovat iterátory. Nespoléhejte na pořadí jejích volání; nejjednodušší je vracet výsledek bez vedlejších účinků.

Příklad ukazuje obě formy bez zásad provádění. Tento záznam cílí na C++23; dodaný návrh standardu je průběžně aktualizovaný dokument a obsahuje také pozdější rozšíření, která příklad nepoužívá.

Příklady

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

Výsledek

1 4 9
2 6 12

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje