Namespaces
Variants

std::ranges:: constant_range

From cppreference.net
Ranges library
Range adaptors
Défini dans l'en-tête <ranges>
template < class T >

concept constant_range =
ranges:: input_range < T > &&

/*constant-iterator*/ < ranges:: iterator_t < T >> ;
(1) (depuis C++23)
Concepts auxiliaires
template < class T >

concept /*constant-iterator*/ =
std:: input_iterator < T > &&

std:: same_as < std:: iter_const_reference_t < T > , std:: iter_reference_t < T >> ;
(2) ( exposition uniquement* )
1) Le concept constant_range est un raffinement du concept range pour lequel ranges::begin retourne un itérateur constant .
2) Le concept /*constant-iterator*/ < T > est satisfait lorsque le résultat de l'opération d'indirection de l'itérateur d'entrée est son type de référence const, ce qui implique une lecture seule.

Exemple

#include <ranges>
#include <span>
#include <string_view>
#include <vector>
// mécanismes pour garantir que le paramètre est une plage constante
// 1) un ensemble de surcharges où la version mutable délègue à la version constante
template<std::ranges::constant_range R>
void takes_any_range1(R&& r)
{
    // R est définitivement une plage constante
}
template<std::ranges::range R>
void takes_any_range1(R&& r)
{
    takes_any_range1(std::views::as_const(std::forward<R>(r)));
}
// 2) un modèle de fonction qui masque son paramètre
template<std::ranges::range R>
void takes_any_range2(R&& _r)
{
    auto r = std::views::as_const(std::forward<R>(_r));
    // r est définitivement une plage constante
    // ne plus jamais utiliser _r
}
// 3) un modèle de fonction qui s'invoque récursivement
template<std::ranges::range R>
void takes_any_range3(R&& r)
{
    if constexpr (std::ranges::constant_range<R>)
    {
        // R est définitivement une plage constante
        // placer l'implémentation ici
    }
    else
        takes_any_range3(std::views::as_const(std::forward<R>(r)));
}
static_assert
(
        std::ranges::constant_range<const std::vector<int>> and
    not std::ranges::constant_range<std::vector<int>> and
        std::ranges::constant_range<std::string_view> and
    not std::ranges::constant_range<std::span<int>> and
        std::ranges::constant_range<std::span<const int>> and
    not std::ranges::constant_range<const std::span<int>>
);
int main() {}