Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::ranges::input_range — čitateľný rozsah

std::ranges::input_range opisuje rozsah, ktorého iterátor umožňuje čítať prvky a posúvať sa na ďalšie pozície. Nezaručuje viacero prechodov: čítanie môže údaje spotrebovať, napríklad pri pohľade na prúd.

Verzia: 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> je koncept z hlavičky <ranges>. Jeho definícia kombinuje std::ranges::range<T> s std::input_iterator<std::ranges::iterator_t<T>>. Rozsah poskytuje počiatočný iterátor a koncovú sentinelu; iterátor umožňuje čítanie a inkrementáciu. Ide o typové obmedzenie kontrolované pri kompilácii, nie o kontajner ani operáciu čítania.

Nepredpokladajte, že možno prechod opakovať alebo že uložené pozície iterátorov sú nezávislé. Vstupný rozsah môže byť jednopriechodový; opätovné zavolanie begin nemusí obnoviť počiatočnú pozíciu. Silnejší std::ranges::forward_range zaručuje viacero prechodov. std::ranges::input_range tiež nevyžaduje, aby iterátor a sentinel mali rovnaký typ — túto požiadavku vyjadruje std::ranges::common_range.

Možnosť čítať neznamená, že prvky sú nemenné alebo že ich možno zapisovať. Koncept nevyžaduje ani známu veľkosť, ani súvislé uloženie v pamäti. Použite ho na obmedzenie šablóny, keď algoritmus potrebuje čítať počas jediného prechodu; ďalšie operácie s prvkami môžu vyžadovať samostatné obmedzenia.

Príklad používa std::views::istream<int> nad prúdom v pamäti. Asercie ukazujú vstupný rozsah, ktorý nie je dopredným rozsahom. Cyklus číta čísla z prúdu a priebežne ich sčítava. Príkaz po cykle vypíše súčet iba raz: 60 a za ním znak nového riadka. Nerobte predbežný prechod iba preto, aby ste pred spracovaním spočítali prvky.

Prí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ýsledok

60

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje