Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ranges::view_interface — interfaccia per viste personalizzate

std::ranges::view_interface è una classe base CRTP per viste personalizzate. Fornisce membri di comodità a partire dalle operazioni di range, ma la loro disponibilità dipende dalle capacità dell’iteratore e del sentinel.

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

Sintassi

#include <ranges>

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

std::ranges::view_interface<D> usa CRTP: D eredita pubblicamente dalla specializzazione con il proprio tipo. Implementi begin() e end(); la classe base ne ricava operazioni di comodità. La sola ereditarietà non sostituisce i requisiti di std::ranges::view, compresi quelli semantici. Una view non deve necessariamente essere non proprietaria.

I membri sono disponibili in modo condizionale: front() richiede forward_range, back() richiede inoltre bidirectional_range e common_range, mentre operator[] richiede random_access_range. size() richiede forward_range e sized_sentinel_for; data() richiede un iteratore contiguo. empty() funziona per sized_range o forward_range. L’operator bool esplicito verifica che il range non sia vuoto quando ranges::empty è valido. Gli overload const verificano i requisiti corrispondenti per const D.

front() e back() richiedono un range non vuoto. operator[] non controlla i limiti; l’indice deve indicare un elemento esistente. L’int_view dell’esempio non possiede i dati: l’array deve rimanere in vita durante l’accesso tramite la view. Una view const non implica che gli elementi siano immutabili, perché il suo begin() restituisce int*.

Questa voce riguarda C++23. Il documento fornito è una bozza di lavoro in evoluzione e può includere aggiunte successive, come at(); non considerarlo una specifica C++23 immutabile. Un flag del compilatore nel repository non attesta il comportamento in un ambiente di produzione.

Esempi

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

Risultato

false 3
10 30 20
11

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti