База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::ranges::to — създаване на контейнер от диапазон

C++23 std::ranges::to създава обект, обикновено контейнер, от входен диапазон. Позволява да завършите конвейер от изгледи с конкретен резултат, като посочите пълния тип на контейнера или шаблон, чиито аргументи ще бъдат изведени.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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, налична от C++23 в <ranges>, създава резултат от диапазон, който удовлетворява input_range. При контейнер като std::vector<int> тя материализира елементите, вместо да създава още един ленив изглед. Целевият тип C трябва да е класов тип без cv-квалификатори и не трябва да удовлетворява view.

Изразът std::ranges::to<std::vector<int>>(range) задава изрично типа на резултата. Формата std::ranges::to<std::vector>(range) използва извеждане на аргументите на шаблона на клас. В конвейер използвайте range | std::ranges::to<std::vector<int>>(): () създават затварящ обект за конвейера. Допълнителните args..., например алокатор, се подават към избрания конструктор на контейнера.

За директно преобразуеми елементи функцията изпробва последователно: конструктор, който приема диапазона; конструктор с етикет std::from_range; подходящ конструктор, приемащ двойка итератори; и накрая конструиране с args..., последвано от вмъкване на елементите. Всеки път има свои изисквания. Вложените диапазони могат да се преобразуват рекурсивно; ако не е приложим нито един разрешен път, програмата е невалидно формирана.

Примерът създава std::vector<int> с квадратите на числата от 1 до 5; горната граница на std::views::iota(1, 6) не се включва. Материализирането на този конвейер обхожда елементите му, затова не използвайте неограничен диапазон, без да ограничите броя на елементите. Необходима е реализация на библиотеката, която поддържа тази функция от C++23: само флагът на компилатора в хранилището не удостоверява поддръжка в производствена среда. Посоченият източник е развиващ се проект на стандарт, а не замразено издание на C++23.

Примери

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

Резултат

1 4 9 16 25

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници