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.