Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ranges::view_interface — interfejs własnego widoku

std::ranges::view_interface to baza CRTP dla własnych widoków. Na podstawie operacji zakresu udostępnia metody pomocnicze, ale ich dostępność zależy od możliwości iteratorów i wartownika.

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

Składnia

#include <ranges>

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

std::ranges::view_interface<D> stosuje CRTP: D publicznie dziedziczy po specjalizacji z własnym typem. Implementujesz begin() i end(); baza wyprowadza operacje pomocnicze. Samo dziedziczenie nie zastępuje wymagań konceptu std::ranges::view, w tym wymagań semantycznych. Widok nie musi być niewłaścicielem danych.

Dostępność metod jest warunkowa: front() wymaga forward_range, back() dodatkowo bidirectional_range i common_range, a operator[] — random_access_range. size() wymaga forward_range oraz sized_sentinel_for; data() wymaga iteratora ciągłego. empty() działa dla sized_range lub forward_range. Jawny operator bool sprawdza niepustość, jeśli ranges::empty jest poprawne. Przeciążenia const sprawdzają odpowiednie wymagania dla const D.

front() i back() wymagają niepustego zakresu. operator[] nie sprawdza granic; indeks musi wskazywać istniejący element. Przykładowy int_view nie posiada danych: tablica musi istnieć podczas dostępu przez widok. const widoku nie oznacza niezmienności elementów, ponieważ jego begin() zwraca int*.

Zakres wpisu to C++23. Podany dokument jest rozwijanym szkicem i może zawierać późniejsze dodatki, takie jak at(); nie traktuj go jako zamrożonej specyfikacji C++23. Flaga kompilatora w repozytorium nie potwierdza działania w środowisku produkcyjnym.

Przykłady

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

Wynik

false 3
10 30 20
11

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła