Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::ranges::transform — pretvaranje elemenata u izlaz

std::ranges::transform izračunava vrijednosti iz jednog raspona ili odgovarajućih elemenata dvaju raspona i zapisuje ih putem izlaznog iteratora. To je algoritam koji djeluje odmah, a ne lijeni pogled.

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

Sintaksa

#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 iz <algorithm> prihvaća raspone ili parove iterator–sentinel. Unarni oblik pretvara svaki element; binarni oblik kombinira odgovarajuće elemente i završava na kraćem ulaznom rasponu. Neobavezne projekcije proj, proj1, proj2 primjenjuju se prije operacije; prema zadanim postavkama ne mijenjaju argumente.

Izlaz mora omogućiti zapis svih rezultata. Algoritam ne povećava spremnik: sam reserve() ne stvara elemente. Osigurajte postojeće elemente ili upotrijebite std::back_inserter s prikladnim spremnikom. Pretvorba na mjestu dopuštena je kada izlaz počinje na početku jednog od ulaza. Sama operacija ne smije mijenjati elemente raspona ni poništiti iteratore.

Rezultat izlaže završne pozicije kao .in i .out, ili kao .in1, .in2 i .out. Za privremeni raspon koji nije borrowed range, ulazno polje može biti tipa std::ranges::dangling. Za N zapisanih rezultata operacija i svaka projekcija pozivaju se točno N puta.

Za razliku od lijenog pogleda std::views::transform, ovaj algoritam zapisuje rezultate prije povratka. Ovaj zapis opisuje uporabu u C++23; trenutačni radni nacrt sadrži i kasnija proširenja. Zastavica prevoditelja u repozitoriju ne potvrđuje kompatibilnost produkcijskog izvršnog okruženja.

Primjeri

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

Rezultat

1 4 9 16

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori