Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::ranges::transform — transformácia prvkov do výstupu

std::ranges::transform počíta hodnoty z jedného rozsahu alebo zodpovedajúcich prvkov dvoch rozsahov a zapisuje ich pomocou výstupného iterátora. Je to algoritmus vykonávajúci prácu okamžite, nie lenivý pohľad.

Verzia: 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 z <algorithm> prijíma rozsahy alebo dvojice iterátor–sentinel. Unárna forma transformuje každý prvok; binárna forma kombinuje zodpovedajúce prvky a končí na kratšom vstupnom rozsahu. Voliteľné projekcie proj, proj1, proj2 sa použijú pred operáciou; predvolene argumenty nemenia.

Výstup musí umožňovať zápis všetkých výsledkov. Algoritmus kontajner nezväčšuje: samotné reserve() nevytvorí žiadne prvky. Zabezpečte existujúce prvky alebo použite std::back_inserter s vhodným kontajnerom. Transformácia na mieste je povolená, ak výstup začína na začiatku jedného zo vstupov. Samotná operácia nesmie meniť prvky rozsahu ani zneplatniť iterátory.

Výsledok sprístupňuje koncové pozície ako .in a .out, alebo ako .in1, .in2 a .out. Pri dočasnom rozsahu, ktorý nie je borrowed range, môže mať vstupné pole typ std::ranges::dangling. Pre N zapísaných výsledkov sa operácia aj každá projekcia zavolajú presne N-krát.

Na rozdiel od lenivého pohľadu std::views::transform tento algoritmus zapíše výsledky pred návratom. Tento záznam opisuje použitie v C++23; aktuálny pracovný návrh obsahuje aj neskoršie rozšírenia. Príznak kompilátora v repozitári nepotvrdzuje kompatibilitu produkčného runtime prostredia.

Príklady

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

Výsledok

1 4 9 16

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje