Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje