Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje