База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници