KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ranges::input_range — een leesbaar bereik

std::ranges::input_range beschrijft een bereik waarvan de iterator elementen kan lezen en naar volgende posities kan gaan. Meerdere doorgangen zijn niet gegarandeerd: lezen kan gegevens verbruiken, zoals bij een stream view.

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

Syntax

#include <ranges>

template<class T>
concept input_range = std::ranges::range<T> &&
                      std::input_iterator<std::ranges::iterator_t<T>>;

// Usage:
template<std::ranges::input_range R>
void consume(R&& r);

std::ranges::input_range<T> is een concept uit <ranges>. De definitie combineert std::ranges::range<T> met std::input_iterator<std::ranges::iterator_t<T>>. Het bereik biedt een begin-iterator en een eindsentinel; de iterator kan lezen en worden opgehoogd. Dit is een typebeperking die tijdens het compileren wordt gecontroleerd, geen container of leesbewerking.

Ga er niet van uit dat je de doorgang kunt herhalen of dat opgeslagen iteratorposities onafhankelijk zijn. Een inputbereik kan slechts één doorgang ondersteunen; een nieuwe aanroep van begin hoeft de beginpositie niet te herstellen. Het sterkere std::ranges::forward_range garandeert meerdere doorgangen. std::ranges::input_range vereist ook niet dat iterator en sentinel hetzelfde type hebben — die eis wordt uitgedrukt door std::ranges::common_range.

Leesbaarheid betekent niet dat elementen onveranderlijk zijn of dat je ze mag beschrijven. Het concept vereist evenmin een bekende grootte of aaneengesloten opslag. Gebruik het om een template te beperken wanneer een algoritme tijdens één doorgang moet lezen; voor extra bewerkingen op elementen kunnen aparte beperkingen nodig zijn.

Het voorbeeld gebruikt std::views::istream<int> op een stream in het geheugen. De assertions tonen een inputbereik dat geen forwardbereik is. De lus leest de getallen uit de stream en telt ze bij elkaar op. De instructie na de lus drukt de som één keer af: 60, gevolgd door een regeleinde. Maak geen voorafgaande doorgang alleen om de elementen te tellen voordat je ze verwerkt.

Voorbeelden

#include <iostream>
#include <locale>
#include <ranges>
#include <sstream>

int main() {
    std::istringstream stream{"10 20 30"};
    stream.imbue(std::locale::classic());
    auto numbers = std::views::istream<int>(stream);

    static_assert(std::ranges::input_range<decltype(numbers)>);
    static_assert(!std::ranges::forward_range<decltype(numbers)>);

    int total = 0;
    for (int value : numbers) {
        total += value;
    }
    std::cout << total << '\n';
}

Resultaat

60

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