KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen