WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::ranges::view_interface — Schnittstelle für eigene Views

std::ranges::view_interface ist eine CRTP-Basisklasse für eigene Views. Sie stellt aus Range-Operationen Komfortfunktionen bereit; welche verfügbar sind, hängt jedoch von den Fähigkeiten des Iterators und des Sentinels ab.

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

Syntax

#include <ranges>

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

std::ranges::view_interface<D> verwendet CRTP: D erbt öffentlich von der Spezialisierung mit seinem eigenen Typ. Du implementierst begin() und end(); die Basisklasse leitet daraus Komfortoperationen ab. Die Vererbung allein erfüllt nicht die Anforderungen von std::ranges::view, einschließlich der semantischen Anforderungen. Ein View muss nicht nicht-besitzend sein.

Die Member sind bedingt verfügbar: front() erfordert forward_range, back() zusätzlich bidirectional_range und common_range, und operator[] erfordert random_access_range. size() erfordert forward_range und sized_sentinel_for; data() erfordert einen zusammenhängenden Iterator. empty() funktioniert für sized_range oder forward_range. Der explizite operator bool prüft auf Nicht-Leere, wenn ranges::empty gültig ist. Die const-Überladungen prüfen die entsprechenden Anforderungen für const D.

front() und back() erfordern eine nicht leere Range. operator[] prüft keine Grenzen; der Index muss ein vorhandenes Element bezeichnen. Das int_view-Beispiel besitzt seine Daten nicht: Das Array muss während des Zugriffs über den View bestehen bleiben. Ein const-View bedeutet nicht, dass die Elemente unveränderlich sind, denn sein begin() gibt int* zurück.

Dieser Eintrag bezieht sich auf C++23. Das bereitgestellte Dokument ist ein fortlaufend weiterentwickelter Arbeitsentwurf und kann spätere Ergänzungen wie at() enthalten; betrachte es nicht als eingefrorene C++23-Spezifikation. Ein Compiler-Flag im Repository bestätigt kein Verhalten in einer Produktionslaufzeit.

Beispiele

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

Ergebnis

false 3
10 30 20
11

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen