KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ranges::subrange — een iterator-sentinelweergave

std::ranges::subrange uit <ranges> combineert een begin-iterator en een eindsentinel tot een weergave van [first, last). Het kopieert geen elementen naar een nieuwe container, maar laat je een geselecteerd deel van de gegevens als één object doorgeven.

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

Syntax

#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();

std::ranges::subrange<I, S, K> slaat een iterator en een sentinel op en vormt daarmee een weergave van [first, last): het begin is inbegrepen en het einde uitgesloten. De typen I en S mogen verschillen; de opslag hoeft niet aaneengesloten te zijn. Neem <ranges> op. Bij het construeren van std::ranges::subrange(first, last) worden de templateargumenten afgeleid.

std::ranges::subrange::begin retourneert een kopie van de opgeslagen iterator wanneer I voldoet aan copyable. Anders is alleen de niet-const-overload beschikbaar, die de opgeslagen iterator verplaatst; ga er dan niet van uit dat herhaalde aanroepen hetzelfde begin opleveren. std::ranges::subrange::end retourneert een kopie van de sentinel. Vergelijk een iterator met end() voordat je deze derefereert; de sentinel zelf hoeft dereferentie niet te ondersteunen.

K kiest subrange_kind::sized of subrange_kind::unsized. Alleen de variant sized biedt size(): deze berekent het resultaat door de eindpunten van elkaar af te trekken, of slaat een grootte op wanneer die aftrekking niet beschikbaar is. De constructor met argument n vereist dat n gelijk is aan de werkelijke lengte van het geldige bereik [first, last).

De weergave kopieert geen elementen en verlengt zelf de levensduur van de gegevens niet. Gebruik haar niet nadat de gegevens zijn vernietigd of de iterators ongeldig zijn geworden. Een wijziging via een schrijfbare iterator verandert de oorspronkelijke gegevens; de weergave zelf const maken, maakt de elementen niet constant.

Het voorbeeld omvat values[1], values[2] en values[3]. Nadat het eerste daarvan is gewijzigd in 21, drukt het precies sum=91 en values[1]=21 af, elk op een eigen regel. Reikwijdte van de omgevingsinformatie: C++23; compileroptie van de repository, compatibiliteit met de productieomgeving niet bevestigd. De online standaard is een evoluerend concept, geen bevroren C++23-publicatie.

Voorbeelden

#include <iostream>
#include <ranges>

int main() {
    int values[] = {10, 20, 30, 40, 50};
    auto middle = std::ranges::subrange(values + 1, values + 4);

    *middle.begin() = 21;
    int sum = 0;
    for (auto it = middle.begin(); it != middle.end(); ++it) {
        sum += *it;
    }

    std::cout << "sum=" << sum << '\n';
    std::cout << "values[1]=" << values[1] << '\n';
}

Resultaat

sum=91
values[1]=21

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