Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::ranges::input_range — čitljiv raspon

std::ranges::input_range opisuje raspon čiji iterator omogućuje čitanje elemenata i pomicanje na sljedeće položaje. Ne jamči više prolazaka: čitanje može trošiti podatke, kao kod pogleda na tok.

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

Sintaksa

#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> koncept je iz zaglavlja <ranges>. Njegova definicija kombinira std::ranges::range<T> s std::input_iterator<std::ranges::iterator_t<T>>. Raspon pruža početni iterator i završni sentinel, a iterator omogućuje čitanje i inkrementiranje. Riječ je o ograničenju tipa koje se provjerava tijekom kompilacije, a ne o spremniku ili operaciji čitanja.

Nemoj pretpostaviti da se prolazak može ponoviti ili da su spremljeni položaji iteratora neovisni. Ulazni raspon može biti jednoprolazan; ponovni poziv begin ne mora vratiti početni položaj. Jači std::ranges::forward_range jamči više prolazaka. std::ranges::input_range također ne zahtijeva da iterator i sentinel imaju iste tipove — taj zahtjev izražava std::ranges::common_range.

Mogućnost čitanja ne znači da su elementi nepromjenjivi niti da ih je dopušteno zapisivati. Koncept ne zahtijeva ni poznatu veličinu ni pohranu u neprekinutom nizu. Upotrijebi ga za ograničavanje predloška kada algoritam mora čitati tijekom jednog prolaska; dodatne operacije nad elementima mogu zahtijevati zasebna ograničenja.

Primjer koristi std::views::istream<int> nad tokom u memoriji. Asercije pokazuju da je riječ o ulaznom rasponu koji ne zadovoljava koncept std::ranges::forward_range i stoga ne jamči višestruke prolaze. Petlja čita brojeve iz toka i zbraja ih kako ih čita. Naredba nakon petlje ispisuje zbroj samo jednom: 60, nakon čega slijedi znak novog retka. Nemoj obavljati prethodni prolazak samo zato da bi prebrojio elemente prije obrade.

Primjeri

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

Rezultat

60

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori