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

CKTIS / C++

std::ranges::view_interface — interface pour les vues personnalisées

std::ranges::view_interface est une classe de base CRTP pour les vues personnalisées. Elle fournit des fonctions pratiques à partir des opérations de plage, mais leur disponibilité dépend des capacités de l’itérateur et du sentinelle.

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

Syntaxe

#include <ranges>

class D : public std::ranges::view_interface<D> {
public:
    // Provide begin() and end().
};

std::ranges::view_interface<D> utilise le CRTP : D hérite publiquement de la spécialisation avec son propre type. Vous implémentez begin() et end() ; la classe de base en déduit des opérations pratiques. L’héritage seul ne remplace pas les exigences de std::ranges::view, y compris ses exigences sémantiques. Une vue n’a pas nécessairement une sémantique non propriétaire.

Les membres sont conditionnels : front() exige forward_range, back() exige en plus bidirectional_range et common_range, et operator[] exige random_access_range. size() exige forward_range et sized_sentinel_for ; data() exige un itérateur contigu. empty() fonctionne pour sized_range ou forward_range. operator bool explicite teste si la plage est non vide lorsque ranges::empty est valide. Les surcharges const vérifient les exigences correspondantes pour const D.

front() et back() exigent une plage non vide. operator[] ne vérifie pas les limites ; l’indice doit désigner un élément existant. Le int_view de l’exemple ne possède pas ses données : le tableau doit rester vivant pendant l’accès via la vue. Une vue const n’implique pas que ses éléments soient immuables, car son begin() renvoie int*.

Cette entrée concerne C++23. Le document fourni est un projet de travail évolutif et peut inclure des ajouts ultérieurs, tels que at() ; ne le considérez pas comme une spécification C++23 figée. Un indicateur de compilateur dans le dépôt ne garantit pas le comportement dans un environnement de production.

Exemples

#include <iostream>
#include <ranges>

class int_view : public std::ranges::view_interface<int_view> {
    int* first_;
    int* last_;

public:
    int_view(int* first, int* last) : first_(first), last_(last) {}

    int* begin() const { return first_; }
    int* end() const { return last_; }
};

static_assert(std::ranges::view<int_view>);
static_assert(std::ranges::contiguous_range<int_view>);

int main() {
    int values[] = {10, 20, 30};
    int_view v(values, values + 3);

    std::cout << std::boolalpha << v.empty() << ' ' << v.size() << '\n';
    std::cout << v.front() << ' ' << v.back() << ' ' << v[1] << '\n';
    v.front() = 11;
    std::cout << values[0] << '\n';
}

Résultat

false 3
10 30 20
11

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