Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ranges::to — tworzenie kontenera z zakresu

std::ranges::to z C++23 tworzy obiekt, zwykle kontener, z zakresu wejściowego. Pozwala zakończyć potok widoków konkretnym wynikiem, wskazując pełny typ kontenera albo szablon, którego argumenty zostaną wywnioskowane.

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

Składnia

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, dostępne od C++23 w <ranges>, tworzy wynik z zakresu spełniającego input_range. Dla kontenera, takiego jak std::vector<int>, materializuje elementy zamiast tworzyć kolejny leniwy widok. Docelowy typ C musi być typem klasowym bez kwalifikatorów cv i nie może spełniać view.

Zapis std::ranges::to<std::vector<int>>(range) jawnie określa typ wyniku. Wariant std::ranges::to<std::vector>(range) wykorzystuje dedukcję argumentów szablonu klasy. W potoku użyj range | std::ranges::to<std::vector<int>>(): nawiasy () tworzą obiekt domykający potok. Dodatkowe args..., np. alokator, są przekazywane do wybranego konstruktora kontenera.

Dla bezpośrednio konwertowalnych elementów funkcja próbuje kolejno: konstruktora przyjmującego zakres, konstruktora ze znacznikiem std::from_range, odpowiedniego konstruktora przyjmującego parę iteratorów, a następnie konstrukcji z args... i wstawiania elementów. Każda ścieżka ma własne wymagania. Zagnieżdżone zakresy mogą być konwertowane rekurencyjnie; gdy żadna dozwolona ścieżka nie pasuje, program jest niepoprawny.

Przykład tworzy std::vector<int> z kwadratami liczb od 1 do 5; górna granica std::views::iota(1, 6) jest wyłączna. Materializacja takiego potoku przechodzi po jego elementach, więc nie używaj nieograniczonego zakresu bez ograniczenia liczby elementów. Wymagana jest implementacja biblioteki obsługująca tę funkcję C++23: sama flaga kompilatora w repozytorium nie potwierdza obsługi w środowisku produkcyjnym. Podany odnośnik prowadzi do rozwijanego szkicu standardu, nie zamrożonego wydania C++23.

Przykłady

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

Wynik

1 4 9 16 25

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła