common_view class (standardní knihovna jazyka C++)

Vezměte rozsah, který může mít různé typy iterátoru a sentinelu, a vytvořte zobrazení se stejným typem iterátoru a sentinelu. To je užitečné pro volání algoritmů STL, které přijímají rozsahy určené páry iterátoru.

Syntaxe

template<ranges::view V>
    requires (!ranges::common_range<V> && std::copyable<ranges::iterator_t<V>>)
class common_view : public ranges::view_interface<common_view<V>>;

Parametry šablony

V
Typ podkladového zobrazení.

Zobrazení charakteristik

Popis následujících položek naleznete v tématu Zobrazení vlastností třídy.

Charakteristika	Popis
Adaptér rozsahu	views::common
Podkladová oblast	Musí splňovat forward_range nebo vyšší
Typ elementu	Stejné jako podkladová oblast
Zobrazit kategorii iterátoru	forward_range nebo random_access_range v případech, kdy základní rozsah splňuje random_access_range a sized_range
Tříděný	Pouze v případě, že základní rozsah splňuje požadavky sized_range
Je const-iterable	Pouze v případě, že je const základní rozsah iterovatelný
Společný rozsah	Ano
Zapůjčený rozsah	Pouze v případě, že základní rozsah splňuje požadavky borrowed_range

Členové

Členské funkce	Popis
KonstruktoryC++20	Vytvoření .common_view
baseC++20	Získejte podkladové zobrazení.
beginC++20	Získejte iterátor k prvnímu prvku v zobrazení.
endC++20	Získejte sentinel na konci zobrazení.
sizeC++20	Získejte počet prvků v zobrazení.
Zděděno z view_interface	Popis
backC++20	Získejte poslední prvek.
dataC++20	Získejte ukazatel na první prvek.
emptyC++20	Otestujte, jestli je zobrazení prázdné.
frontC++20	Získejte první prvek.
operator[]C++20	Získejte prvek na zadané pozici.
operator boolC++20	Otestujte, jestli zobrazení není prázdné.

Poznámky

Nejlepší způsob, jak vytvořit, common_view je použití adaptéru rozsahu views::common . Adaptéry rozsahu představují zamýšlený způsob vytváření tříd zobrazení. Typy zobrazení jsou vystaveny pro případ, že chcete vytvořit vlastní typ zobrazení.

Toto zobrazení je užitečné pro předávání rozsahu s různými typy iterátoru nebo sentinelu do staršího algoritmu, který očekává, že budou stejné.

Požadavky

Hlavička: <ranges> (od C++20)

Obor názvů: std::ranges

Je vyžadována možnost kompilátoru: /std:c++20 nebo novější.

Konstruktory

Vytvořte instanci objektu common_view.

1) common_view() = default;
2) constexpr explicit common_view(V v);

Parametry

v
Podkladové zobrazení.

Informace o typu parametru šablony naleznete v tématu Parametry šablony.

Poznámky

1) Výchozí konstrukce common_view.
2) Vytvoří common_view z podkladového zobrazení pomocí std::move(v). Pokud je běžný rozsah, který V zabrání zneužití, které by negativně ovlivnilo výkon, dojde k chybě.

base

Získá kopii podkladového zobrazení.

// Uses a copy constructor to return the underlying view
constexpr V base() const& requires std::copy_constructible<V>;

// Uses a move constructor to return the underlying view
constexpr V base() &&;

begin

Získejte iterátor k prvnímu prvku.

constexpr auto begin();
constexpr auto begin() const requires range<const V>;

Vrácená hodnota

Iterátor ukazující na první prvek v zobrazení:

end

Získejte sentinel na konci zobrazení.

constexpr auto end();
constexpr auto end() const requires ranges::range<const V>;

Vrácená hodnota

Sentinel, který následuje za posledním prvkem v zobrazení:

size

Získejte počet prvků v zobrazení.

constexpr auto size() requires ranges::sized_range<V>;
constexpr auto size() const requires ranges::sized_range<const V>;

Parametry

Žádná

Vrácená hodnota

Počet prvků v zobrazení.

Viz také

<ranges>
common adaptér rozsahu
zobrazit třídy