CKTIS / C++
std::ranges::to — vytvorenie kontajnera z rozsahu
C++23 std::ranges::to vytvára objekt, zvyčajne kontajner, zo vstupného rozsahu. Umožňuje ukončiť pipeline pohľadov konkrétnym výsledkom zadaním úplného typu kontajnera alebo šablóny, ktorej argumenty sa odvodia.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
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, dostupné od C++23 v <ranges>, vytvára výsledok z rozsahu spĺňajúceho input_range. Pri kontajneri, ako je std::vector<int>, materializuje prvky namiesto vytvorenia ďalšieho lenivého pohľadu. Cieľový typ C musí byť typ triedy bez cv-kvalifikátorov a nesmie spĺňať view.
Výraz std::ranges::to<std::vector<int>>(range) určuje typ výsledku výslovne. Forma std::ranges::to<std::vector>(range) používa odvodzovanie argumentov šablóny triedy. V pipeline použite range | std::ranges::to<std::vector<int>>(): () vytvoria uzatvárací objekt pipeline. Ďalšie args..., napríklad alokátor, sa odovzdajú vybranému konštruktoru kontajnera.
Pri priamo konvertibilných prvkoch funkcia skúša v tomto poradí: konštruktor prijímajúci rozsah, konštruktor označený std::from_range, vhodný konštruktor prijímajúci dvojicu iterátorov a napokon konštrukciu s args..., po ktorej nasleduje vkladanie prvkov. Každá cesta má vlastné požiadavky. Vnorené rozsahy možno konvertovať rekurzívne; ak nevyhovuje žiadna povolená cesta, program je chybne utvorený.
Príklad vytvorí std::vector<int> obsahujúci druhé mocniny čísel od 1 do 5; horná hranica std::views::iota(1, 6) sa nezahŕňa. Materializácia tejto pipeline prechádza jej prvky, preto nepoužívajte neobmedzený rozsah bez obmedzenia počtu prvkov. Potrebná je implementácia knižnice podporujúca túto funkciu C++23: samotný príznak kompilátora v repozitári nedokazuje podporu v produkčnom prostredí. Uvedený odkaz vedie na priebežne vyvíjaný návrh normy, nie na nemenné vydanie C++23.
Príklady
#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';
}
Výsledok
1 4 9 16 25
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.