CKTIS / C++
std::ranges::input_range — un intervallo leggibile
std::ranges::input_range descrive un intervallo il cui iteratore consente di leggere gli elementi e avanzare alle posizioni successive. Non garantisce più passaggi: la lettura può consumare i dati, come accade con una vista di flusso.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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> è un concept di <ranges>. La sua definizione combina std::ranges::range<T> con std::input_iterator<std::ranges::iterator_t<T>>. L’intervallo fornisce un iteratore iniziale e una sentinella finale; l’iteratore consente di leggere e incrementare. È un vincolo di tipo verificato in fase di compilazione, non un contenitore né un’operazione di lettura.
Non dare per scontato che il percorso possa essere ripetuto o che le posizioni degli iteratori salvate siano indipendenti. Un intervallo di input può essere a passaggio singolo; una nuova chiamata a begin non deve necessariamente ripristinare la posizione iniziale. Il più forte std::ranges::forward_range garantisce più passaggi. std::ranges::input_range inoltre non richiede che iteratore e sentinella abbiano tipi identici: questo requisito è espresso da std::ranges::common_range.
La possibilità di leggere non implica né che gli elementi siano immutabili né che sia consentito modificarli. Il concept non richiede neppure una dimensione nota o una memoria contigua. Usalo per vincolare un template quando un algoritmo deve leggere durante un solo passaggio; altre operazioni sugli elementi possono richiedere vincoli separati.
L’esempio usa std::views::istream<int> su uno stream in memoria. Le asserzioni mostrano un intervallo di input che non è un intervallo forward. Il ciclo legge i numeri dallo stream e li somma man mano. L’istruzione dopo il ciclo stampa il totale una sola volta: 60 seguito da un carattere di a capo. Non eseguire un passaggio preliminare solo per contare gli elementi prima di elaborarli.
Esempi
#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';
}
Risultato
60
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.