Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::ranges::input_range — čitelný rozsah

std::ranges::input_range popisuje rozsah, jehož iterátor umožňuje číst prvky a postupovat na další pozice. Nezaručuje více průchodů: čtení může data spotřebovávat, například u pohledu na proud.

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

Syntaxe

#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> je koncept z hlavičky <ranges>. Jeho definice kombinuje std::ranges::range<T> s std::input_iterator<std::ranges::iterator_t<T>>. Rozsah poskytuje počáteční iterátor a koncového sentinela; iterátor umožňuje čtení a inkrementaci. Jde o typové omezení kontrolované při kompilaci, nikoli o kontejner nebo operaci čtení.

Nepředpokládejte, že lze průchod opakovat nebo že uložené pozice iterátorů jsou nezávislé. Vstupní rozsah může umožňovat jen jeden průchod; opětovné zavolání begin nemusí obnovit počáteční pozici. Silnější std::ranges::forward_range zaručuje více průchodů. std::ranges::input_range také nevyžaduje, aby iterátor a sentinel měly stejný typ — tento požadavek vyjadřuje std::ranges::common_range.

Možnost číst neznamená, že prvky jsou neměnné, ani že je lze zapisovat. Koncept nevyžaduje ani známou velikost, ani souvislé uložení v paměti. Použijte ho k omezení šablony, když algoritmus potřebuje číst během jednoho průchodu; další operace s prvky mohou vyžadovat samostatná omezení.

Příklad používá std::views::istream<int> nad proudem v paměti. Aserce ukazují vstupní rozsah, který není dopředným rozsahem. Smyčka čte čísla z proudu a průběžně je sčítá. Příkaz po smyčce vypíše součet právě jednou: 60 a za ním znak nového řádku. Neprovádějte předběžný průchod jen proto, abyste před zpracováním spočítali prvky.

Příklady

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

Výsledek

60

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje