WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::ranges::input_range — ein lesbarer Bereich

std::ranges::input_range beschreibt einen Bereich, dessen Iterator Elemente lesen und zu folgenden Positionen weitergehen kann. Mehrere Durchläufe sind nicht garantiert: Beim Lesen können Daten verbraucht werden, etwa bei einer Stream-Ansicht.

Version: 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> ist ein Konzept aus <ranges>. Seine Definition verbindet std::ranges::range<T> mit std::input_iterator<std::ranges::iterator_t<T>>. Der Bereich stellt einen Iterator für den Anfang und einen Sentinel für das Ende bereit; der Iterator unterstützt Lesen und Inkrementieren. Es handelt sich um eine zur Compile-Zeit geprüfte Typbeschränkung, nicht um einen Container oder einen Lesevorgang.

Gehe nicht davon aus, dass sich die Traversierung wiederholen lässt oder gespeicherte Iteratorpositionen unabhängig voneinander sind. Ein Eingabebereich kann nur einen Durchlauf erlauben; ein erneuter Aufruf von begin muss nicht wieder die Ausgangsposition liefern. Die stärkere Eigenschaft std::ranges::forward_range garantiert mehrere Durchläufe. std::ranges::input_range verlangt außerdem nicht, dass Iterator und Sentinel denselben Typ haben — diese Anforderung drückt std::ranges::common_range aus.

Lesbarkeit bedeutet weder, dass Elemente unveränderlich sind, noch, dass sie beschrieben werden dürfen. Das Konzept verlangt auch weder eine bekannte Größe noch zusammenhängende Speicherung. Verwende es als Einschränkung für ein Template, wenn ein Algorithmus beim einmaligen Durchlaufen lesen muss; weitere Operationen auf den Elementen können zusätzliche Einschränkungen erfordern.

Das Beispiel verwendet std::views::istream<int> mit einem In-Memory-Stream. Die Assertions zeigen einen Eingabebereich, der kein Vorwärtsbereich ist. Die Schleife liest die Zahlen aus dem Stream und addiert sie zur laufenden Summe. Die Anweisung nach der Schleife gibt die Summe einmal aus: 60 gefolgt von einem Zeilenumbruch. Führe keinen vorbereitenden Durchlauf nur deshalb aus, um vor der Verarbeitung die Elemente zu zählen.

Beispiele

#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';
}

Ergebnis

60

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen