Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti