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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.