Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::ranges::input_range — une plage lisible

std::ranges::input_range décrit une plage dont l’itérateur permet de lire les éléments et d’avancer vers les positions suivantes. Il ne garantit pas plusieurs parcours : la lecture peut consommer les données, comme avec une vue de flux.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#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> est un concept de <ranges>. Sa définition associe std::ranges::range<T> à std::input_iterator<std::ranges::iterator_t<T>>. La plage fournit un itérateur de début et une sentinelle de fin, et son itérateur permet la lecture et l’incrémentation. Il s’agit d’une contrainte de type vérifiée à la compilation, et non d’un conteneur ni d’une opération de lecture.

Ne supposez pas que le parcours peut être répété ni que des positions d’itérateur enregistrées sont indépendantes. Une plage d’entrée peut être à passage unique ; rappeler begin ne rétablit pas nécessairement la position de départ. Le concept plus fort std::ranges::forward_range garantit plusieurs parcours. std::ranges::input_range n’exige pas non plus que l’itérateur et la sentinelle aient des types identiques — cette exigence est exprimée par std::ranges::common_range.

La possibilité de lire n’implique ni que les éléments soient immuables ni qu’il soit permis de les modifier. Le concept n’exige pas non plus une taille connue ni un stockage contigu. Utilisez-le pour contraindre un modèle lorsqu’un algorithme doit lire pendant un seul parcours ; d’autres opérations sur les éléments peuvent nécessiter des contraintes distinctes.

L’exemple utilise std::views::istream<int> sur un flux en mémoire. Les assertions montrent une plage d’entrée qui n’est pas une plage avant. La boucle lit les nombres du flux et les ajoute au total au fur et à mesure. L’instruction qui suit la boucle affiche le total une seule fois : 60 suivi d’un saut de ligne. N’effectuez pas un parcours préliminaire uniquement pour compter les éléments avant de les traiter.

Exemples

#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';
}

Résultat

60

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources