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

CKTIS / C++

std::ranges::to — vytvoření kontejneru z rozsahu

C++23 std::ranges::to vytváří objekt, obvykle kontejner, ze vstupního rozsahu. Umožňuje zakončit pipeline pohledů konkrétním výsledkem zadáním úplného typu kontejneru nebo šablony, jejíž argumenty se odvodí.

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

Syntaxe

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áří výsledek z rozsahu splňujícího input_range. U kontejneru, jako je std::vector<int>, materializuje prvky místo vytvoření dalšího líného pohledu. Cílový typ C musí být typ třídy bez cv-kvalifikátorů a nesmí splňovat view.

Výraz std::ranges::to<std::vector<int>>(range) určuje typ výsledku výslovně. Forma std::ranges::to<std::vector>(range) používá odvození argumentů šablony třídy. V pipeline použijte range | std::ranges::to<std::vector<int>>(): () vytvoří uzavírací objekt pipeline. Další args..., například alokátor, se předají vybranému konstruktoru kontejneru.

U přímo převoditelných prvků funkce zkouší v tomto pořadí: konstruktor přijímající rozsah, konstruktor označený std::from_range, vhodný konstruktor přijímající dvojici iterátorů a nakonec konstrukci s args... následovanou vkládáním prvků. Každá cesta má vlastní požadavky. Vnořené rozsahy lze převádět rekurzivně; pokud nevyhovuje žádná povolená cesta, program je chybně utvořený.

Příklad vytvoří std::vector<int> obsahující druhé mocniny čísel od 1 do 5; horní mez std::views::iota(1, 6) se nezahrnuje. Materializace této pipeline prochází její prvky, proto nepoužívejte neomezený rozsah bez omezení počtu prvků. Je nutná implementace knihovny podporující tuto funkci C++23: samotný příznak kompilátoru v repozitáři nedokládá podporu v produkčním prostředí. Uvedený odkaz vede na průběžně vyvíjený návrh normy, nikoli na neměnné vydání C++23.

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

1 4 9 16 25

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