CKTIS / C++
std::ranges::input_range — zakres umożliwiający odczyt
std::ranges::input_range opisuje zakres, którego iterator pozwala odczytywać elementy i przechodzić do kolejnych pozycji. Nie gwarantuje wielokrotnego przejścia: odczyt może zużywać dane, jak w przypadku widoku strumienia.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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> to koncept z nagłówka <ranges>. Jego definicja łączy std::ranges::range<T> z std::input_iterator<std::ranges::iterator_t<T>>. Zakres udostępnia iterator początku i wartownik końca, a iterator umożliwia odczyt i inkrementację. To ograniczenie typu sprawdzane podczas kompilacji, nie kontener ani operacja odczytu.
Nie zakładaj możliwości ponownego przejścia ani niezależności zapisanych pozycji iteratora. Zakres wejściowy może być jednoprzejściowy; ponowne wywołanie begin nie musi odtwarzać początku. Gwarancję wielokrotnego przejścia zapewnia mocniejszy std::ranges::forward_range. Sam std::ranges::input_range nie wymaga też identycznych typów iteratora i wartownika — takie wymaganie wyraża std::ranges::common_range.
Odczytywalność nie oznacza niemodyfikowalności elementów ani prawa do ich zapisu. Koncept nie wymaga również znanego rozmiaru ani ciągłego rozmieszczenia danych w pamięci. Ograniczaj nim szablon, gdy algorytm potrzebuje odczytu podczas jednego przejścia; dodatkowe operacje na elementach mogą wymagać osobnych ograniczeń.
Przykład używa std::views::istream<int> nad strumieniem w pamięci. Asercje pokazują zakres wejściowy, który nie jest zakresem wieloprzejściowym. Pętla odczytuje kolejne liczby ze strumienia i dodaje je do sumy. Instrukcja po pętli wypisuje sumę 60 tylko raz, po czym wypisuje znak nowego wiersza. Nie należy wykonywać wstępnego przejścia tylko po to, aby policzyć elementy przed ich przetwarzaniem.
Przykłady
#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';
}
Wynik
60
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.