CKTIS / C++
std::ranges::to — een container maken van een range
C++23 std::ranges::to maakt een object, meestal een container, van een invoer-range. Zo kun je een view-pipeline afsluiten met een concreet resultaat, door het volledige containertype op te geven of een template waarvan de argumenten worden afgeleid.
Versie: 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, sinds C++23 beschikbaar in <ranges>, maakt een resultaat van een range die aan input_range voldoet. Bij een container zoals std::vector<int> materialiseert de functie de elementen in plaats van nog een luie view te maken. Het doeltype C moet een klasse-type zonder cv-kwalificaties zijn en mag niet aan view voldoen.
De expressie std::ranges::to<std::vector<int>>(range) geeft het resultaat-type expliciet op. De vorm std::ranges::to<std::vector>(range) gebruikt deductie van templateargumenten voor klassentemplates. Gebruik in een pipeline range | std::ranges::to<std::vector<int>>(): de () maken een pipeline-closureobject. Extra args..., zoals een allocator, worden doorgegeven aan de gekozen containerconstructor.
Voor rechtstreeks converteerbare elementen probeert de functie achtereenvolgens: een constructor die de range accepteert, een constructor met de tag std::from_range, een geschikte constructor met een iteratorpaar, en ten slotte constructie met args... gevolgd door het invoegen van elementen. Elke route heeft eigen vereisten. Geneste ranges kunnen recursief worden geconverteerd; als geen toegestane route van toepassing is, is het programma onjuist gevormd.
Het voorbeeld maakt een std::vector<int> met de kwadraten van 1 tot en met 5; de bovengrens van std::views::iota(1, 6) is exclusief. Het materialiseren van deze pipeline doorloopt de elementen. Gebruik daarom geen onbegrensde range zonder het aantal elementen te beperken. Er is een bibliotheekimplementatie nodig die deze C++23-functie ondersteunt: alleen de compileroptie van de repository bewijst geen ondersteuning in productie. De opgegeven referentie is een zich ontwikkelend normontwerp, geen vastgelegde C++23-editie.
Voorbeelden
#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';
}
Resultaat
1 4 9 16 25
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.