CKTIS / C++
std::ranges::view_interface — rozhraní pro vlastní pohledy
std::ranges::view_interface je základní třída CRTP pro vlastní pohledy. Poskytuje pomocné členy odvozené z operací rozsahu, jejich dostupnost však závisí na schopnostech iterátoru a sentinelu.
Verze: 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> používá CRTP: D veřejně dědí ze specializace s vlastním typem. Implementujete begin() a end(); základní třída z nich odvozuje pomocné operace. Samotné dědění nenahrazuje požadavky konceptu std::ranges::view, včetně sémantických požadavků. Pohled nemusí být nevlastnící.
Členy jsou dostupné podmíněně: front() vyžaduje forward_range, back() navíc vyžaduje bidirectional_range a common_range a operator[] vyžaduje random_access_range. size() vyžaduje forward_range a sized_sentinel_for; data() vyžaduje spojitý iterátor. empty() funguje pro sized_range nebo forward_range. Explicitní operator bool zjišťuje neprázdnost, pokud je platné ranges::empty. Přetížení const ověřují odpovídající požadavky pro const D.
front() a back() vyžadují neprázdný rozsah. operator[] nekontroluje meze; index musí označovat existující prvek. int_view v příkladu data nevlastní: pole musí zůstat naživu po dobu přístupu prostřednictvím pohledu. Pohled const neznamená, že jeho prvky nelze měnit, protože jeho begin() vrací int*.
Tento záznam se vztahuje k C++23. Dodaný dokument je průběžně aktualizovaný pracovní návrh a může obsahovat pozdější doplňky, například at(); nepovažujte jej za neměnnou specifikaci C++23. Příznak kompilátoru v repozitáři nepotvrzuje chování v produkčním prostředí.
Příklady
#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';
}
Výsledek
false 3 10 30 20 11
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.