CKTIS / C++
std::ranges::to — ustvarjanje vsebnika iz območja
C++23 std::ranges::to ustvari objekt, običajno vsebnik, iz vhodnega območja. Omogoča, da cevovod pogledov zaključite s konkretnim rezultatom, tako da navedete polni tip vsebnika ali predlogo, katere argumenti se izpeljejo.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
std::ranges::to<C>(range, args...)
range | std::ranges::to<C>(args...)
std::ranges::to<ContainerTemplate>(range, args...)
range | std::ranges::to<ContainerTemplate>(args...)std::ranges::to, ki je od C++23 na voljo v <ranges>, ustvari rezultat iz območja, ki izpolnjuje input_range. Pri vsebniku, kot je std::vector<int>, materializira elemente, namesto da bi ustvaril še en len pogled. Ciljni tip C mora biti razredni tip brez kvalifikatorjev cv in ne sme izpolnjevati view.
Izraz std::ranges::to<std::vector<int>>(range) izrecno določi tip rezultata. Oblika std::ranges::to<std::vector>(range) uporabi izpeljavo argumentov predloge razreda. V cevovodu uporabite range | std::ranges::to<std::vector<int>>(): () ustvari zapiralni objekt cevovoda. Dodatni args..., na primer alokator, se posredujejo izbranemu konstruktorju vsebnika.
Za neposredno pretvorljive elemente funkcija poskusi po vrsti: konstruktor, ki sprejme območje, konstruktor z oznako std::from_range, ustrezen konstruktor, ki sprejme par iteratorjev, in nazadnje konstrukcijo z args..., ki ji sledi vstavljanje elementov. Vsaka pot ima svoje zahteve. Ugnezdena območja je mogoče pretvarjati rekurzivno; če ne ustreza nobena dovoljena pot, je program napačno oblikovan.
Primer ustvari std::vector<int> s kvadrati števil od 1 do 5; zgornja meja std::views::iota(1, 6) ni vključena. Materializacija tega cevovoda prehodi njegove elemente, zato ne uporabljajte neomejenega območja, ne da bi omejili število elementov. Potrebna je implementacija knjižnice, ki podpira to funkcijo C++23: sam prevajalniški zastavek v repozitoriju ne potrjuje podpore v produkcijskem okolju. Navedena referenca je razvijajoči se osnutek standarda, ne nespremenjena izdaja C++23.
Primeri
#include <cstddef>
#include <iostream>
#include <ranges>
#include <vector>
int main() {
auto values = std::views::iota(1, 6)
| std::views::transform([](int n) { return n * n; })
| std::ranges::to<std::vector<int>>();
for (std::size_t i = 0; i < values.size(); ++i) {
if (i != 0) std::cout << ' ';
std::cout << values[i];
}
std::cout << '\n';
}
Rezultat
1 4 9 16 25
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.