CKTIS / C++
std::ranges::input_range — berljiv obseg
std::ranges::input_range opisuje obseg, katerega iterator omogoča branje elementov in premikanje na naslednje položaje. Ne zagotavlja več prehodov: branje lahko porablja podatke, kot pri pogledu na tok.
Različica: 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> je koncept iz glave <ranges>. Njegova definicija združuje std::ranges::range<T> z std::input_iterator<std::ranges::iterator_t<T>>. Obseg zagotavlja začetni iterator in končno sentinelo, iterator pa omogoča branje in povečevanje. Gre za omejitev tipa, ki se preveri med prevajanjem, ne za vsebnik ali operacijo branja.
Ne predpostavljaj, da je mogoče prehod ponoviti ali da so shranjeni položaji iteratorjev neodvisni. Vhodni obseg je lahko enoprehoden; ponovni klic begin ni nujno vrnitev na začetni položaj. Močnejši std::ranges::forward_range zagotavlja več prehodov. std::ranges::input_range tudi ne zahteva, da imata iterator in sentinel enak tip — to zahtevo izraža std::ranges::common_range.
Možnost branja ne pomeni, da so elementi nespremenljivi ali da jih je dovoljeno zapisovati. Koncept prav tako ne zahteva znane velikosti ali zvezne hrambe. Uporabi ga za omejitev predloge, kadar mora algoritem brati med enim prehodom; dodatne operacije nad elementi lahko zahtevajo ločene omejitve.
Primer uporablja std::views::istream<int> nad tokom v pomnilniku. Asercije pokažejo vhodni obseg, ki ni naprej usmerjen obseg. Zanka bere števila iz toka in jih sproti sešteva. Stavek za zanko vsoto izpiše samo enkrat: 60, za katerim sledi znak za novo vrstico. Ne opravi predhodnega prehoda samo zato, da bi pred obdelavo preštel elemente.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.