CKTIS / C++
std::ranges::view_interface — interface voor aangepaste views
std::ranges::view_interface is een CRTP-basisklasse voor aangepaste views. De klasse biedt handige members op basis van rangebewerkingen, maar welke beschikbaar zijn hangt af van de mogelijkheden van de iterator en sentinel.
Versie: 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> gebruikt CRTP: D erft openbaar van de specialisatie met zijn eigen type. Je implementeert begin() en end(); de basisklasse leidt daar handige bewerkingen uit af. Overerving alleen vervangt niet de vereisten van std::ranges::view, met inbegrip van de semantische vereisten. Een view hoeft niet niet-eigenaarschap te betekenen.
Members zijn voorwaardelijk beschikbaar: front() vereist forward_range, back() vereist daarnaast bidirectional_range en common_range, en operator[] vereist random_access_range. size() vereist forward_range en sized_sentinel_for; data() vereist een aaneengesloten iterator. empty() werkt voor sized_range of forward_range. De expliciete operator bool test of de range niet leeg is wanneer ranges::empty geldig is. De const-overloads controleren de overeenkomstige vereisten voor const D.
front() en back() vereisen een niet-lege range. operator[] controleert de grenzen niet; de index moet naar een bestaand element verwijzen. De int_view in het voorbeeld bezit de gegevens niet: de array moet blijven bestaan zolang je die via de view benadert. Een const-view betekent niet dat de elementen onveranderlijk zijn, want de begin() ervan retourneert int*.
Dit item is gericht op C++23. Het aangeleverde document is een doorlopend bijgewerkt werkdocument en kan latere toevoegingen bevatten, zoals at(); beschouw het niet als een bevroren C++23-specificatie. Een compileroptie in de repository bevestigt geen gedrag in een productieomgeving.
Voorbeelden
#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';
}
Resultaat
false 3 10 30 20 11
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.