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

CKTIS / C++

std::ranges::transform — transformace prvků do výstupu

std::ranges::transform počítá hodnoty z jednoho rozsahu nebo z odpovídajících prvků dvou rozsahů a zapisuje je pomocí výstupního iterátoru. Jde o okamžitě prováděný algoritmus, nikoli o líný pohled.

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

Syntaxe

#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> přijímá rozsahy nebo dvojice iterátor–sentinel. Unární forma transformuje každý prvek; binární forma kombinuje odpovídající prvky a končí na kratším vstupním rozsahu. Volitelné projekce proj, proj1, proj2 se použijí před operací; ve výchozím nastavení argumenty nemění.

Výstup musí umožňovat zápis všech výsledků. Algoritmus kontejner nezvětšuje: samotné reserve() žádné prvky nevytvoří. Zajistěte existující prvky nebo použijte std::back_inserter s vhodným kontejnerem. Transformace na místě je povolena, pokud výstup začíná na začátku jednoho ze vstupů. Samotná operace nesmí měnit prvky rozsahu ani zneplatnit iterátory.

Výsledek zpřístupňuje koncové pozice jako .in a .out, nebo jako .in1, .in2 a .out. U dočasného rozsahu, který není borrowed range, může mít vstupní pole typ std::ranges::dangling. Pro N zapsaných výsledků se operace i každá projekce zavolají přesně Nkrát.

Na rozdíl od líného pohledu std::views::transform tento algoritmus zapíše výsledky před návratem. Tento záznam popisuje použití v C++23; aktuální pracovní návrh obsahuje také pozdější rozšíření. Příznak kompilátoru v repozitáři nepotvrzuje kompatibilitu produkčního běhového prostředí.

Pří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ýsledek

1 4 9 16

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