CKTIS / C++
std::ranges::input_range — четим диапазон
std::ranges::input_range описва диапазон, чийто итератор позволява четене на елементи и придвижване към следващи позиции. Не гарантира многократно обхождане: четенето може да изразходва данните, както при изглед към поток.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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> е концепция от <ranges>. Дефиницията ѝ съчетава std::ranges::range<T> с std::input_iterator<std::ranges::iterator_t<T>>. Диапазонът предоставя начален итератор и краен сентинел, а итераторът позволява четене и инкрементиране. Това е ограничение на типа, проверявано по време на компилация, а не контейнер или операция за четене.
Не приемайте, че обхождането може да се повтори или че запазените позиции на итераторите са независими. Входният диапазон може да допуска само едно преминаване; повторното извикване на begin не е задължително да възстанови началната позиция. По-силната концепция std::ranges::forward_range гарантира многократно обхождане. std::ranges::input_range също не изисква итераторът и сентинелът да са от един и същ тип — това изискване изразява std::ranges::common_range.
Възможността за четене не означава, че елементите са неизменни или че е позволено да се записва в тях. Концепцията не изисква и известен размер или непрекъснато съхранение. Използвайте я, за да ограничите шаблон, когато алгоритъмът трябва да чете при еднократно обхождане; допълнителни операции върху елементите може да изискват отделни ограничения.
Примерът използва std::views::istream<int> върху поток в паметта. Асерциите показват входен диапазон, който не отговаря на изискванията на std::ranges::forward_range за многократно обхождане. Цикълът чете числата от потока и ги събира последователно. Инструкцията след цикъла извежда сумата само веднъж: 60, последвано от знак за нов ред. Не правете предварително обхождане само за да преброите елементите, преди да ги обработите.
Примери
#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';
}
Резултат
60
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.