CKTIS / C++
std::ranges::view_interface — rozhranie pre vlastné pohľady
std::ranges::view_interface je základná trieda CRTP pre vlastné pohľady. Poskytuje pomocné členy odvodené z operácií rozsahu, ich dostupnosť však závisí od schopností iterátora a sentinela.
Verzia: 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> používa CRTP: D verejne dedí zo špecializácie s vlastným typom. Implementujete begin() a end(); základná trieda z nich odvodzuje pomocné operácie. Samotné dedenie nenahrádza požiadavky konceptu std::ranges::view, vrátane sémantických požiadaviek. Pohľad nemusí byť nevlastniaci.
Členy sú dostupné podmienene: front() vyžaduje forward_range, back() navyše 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 súvislý iterátor. empty() funguje pre sized_range alebo forward_range. Explicitný operator bool testuje neprázdnosť, ak je platné ranges::empty. Preťaženia const kontrolujú zodpovedajúce požiadavky pre const D.
front() a back() vyžadujú neprázdny rozsah. operator[] nekontroluje hranice; index musí označovať existujúci prvok. int_view v príklade dáta nevlastní: pole musí zostať živé počas prístupu cez pohľad. Pohľad const neznamená, že jeho prvky sú nemenné, pretože jeho begin() vracia int*.
Tento záznam sa týka C++23. Dodaný dokument je priebežne aktualizovaný pracovný návrh a môže obsahovať neskoršie doplnenia, napríklad at(); nepovažujte ho za nemennú špecifikáciu C++23. Príznak kompilátora v repozitári nepotvrdzuje správanie v produkčnom prostredí.
Prí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ýsledok
false 3 10 30 20 11
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.