owning_view class (standardní knihovna jazyka C++)
Zobrazení, které přebírá vlastnictví prvků v jiné oblasti.
Syntaxe
template<range R>
requires std::movable<R> && (!is-initializer-list<R>)
class owning_view : public ranges::view_interface<owning_view<R>>;
Parametry šablony
R
Typ podkladové oblasti.
Zobrazení charakteristik
Popis následujících položek naleznete v tématu Zobrazení vlastností třídy.
| Charakteristika | Popis |
|---|---|
| Adaptér rozsahu | views::all |
| Podkladová oblast | Musí splňovat input_range nebo vyšší |
| Typ elementu | Stejné jako podkladová oblast |
| Zobrazit kategorii iterátoru | Stejné jako podkladová oblast |
| 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 základní rozsah splňuje požadavky const-iterable |
| Společný rozsah | Pouze v případě, že základní rozsah splňuje požadavky common_range |
| Zapůjčený rozsah | Pouze v případě, že základní rozsah splňuje požadavky borrowed_range |
Členové
| Členské funkce | Popis |
|---|---|
| Konstruktory | Vytvoření objektu owning_view. |
baseC++20 |
Získejte odkaz na vlastněnou oblast. |
beginC++20 |
Získejte iterátor k prvnímu prvku. |
dataC++20 |
Získejte ukazatel na první prvek. |
emptyC++20 |
Otestujte, jestli je zobrazení prázdné. |
endC++20 |
Získejte sentinel na konci zobrazení. |
sizeC++20 |
Získá počet prvků. |
operator= |
Přiřaďte (přesuňte) obsah z jiného owning_view obsahu k tomuto obsahu. |
Zděděno z view_interface |
Popis |
backC++20 |
Získejte poslední prvek. |
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, owning_view je použití adaptéru rozsahu views::all . 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í.
I když tato třída vlastní své prvky, není nákladné vytvořit, protože základní rozsah je přesunut pomocí std::move().
Toto zobrazení je užitečné v případě, že chcete mít rozsah, který nezávisí na životnosti kontejneru poskytujícího prvky.
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 owning_view.
1) owning_view() requires default_initializable<R> = default;
2) constexpr owning_view(R&& rg);
3) owning_view(const owning_view& v) = delete; // no copy constructor
4) owning_view(const owning_view&& v) = default; // move constructor
Parametry
rg
Oblast, do které se má přesunout owning_view.
v
Přechod owning_view na nový owning_view.
Informace o typech parametrů šablony naleznete v tématu Parametry šablony.
Poznámky
1) Výchozí konstruktor vytvoří výchozí inicializovaný owning_view.
2) Přesunutí konstrukce owning_view z rg.
3) Nelze owning_view kopírovat, pouze přesunout.
4) Zkonstruujte owning_view z jiného owning_view.
Příklad: owning_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
#include <utility>
int main()
{
std::vector<int> v = {1,2,3,4,5,6,7,8,9,10};
auto myOwningView = std::views::all(std::move(v)); // create an owning_view from a moved vector
std::cout << v.size() << '\n'; // outputs 0 because myOwningView now owns the elements
std::cout << myOwningView.size() << '\n'; // outputs 10
std::vector<int> v2 = {1,2,3,4,5};
std::ranges::owning_view<std::vector<int>> ov2{std::move(v2)};
std::cout << v2.size() << '\n'; // outputs 0 because ov2 now owns the elements
std::cout << ov2.size() << '\n'; // outputs 5
}
0
10
0
5
base
Získá odkaz na podkladovou oblast.
1) constexpr R& base() & noexcept { return r_; }
2) constexpr const R& base() const & noexcept { return r_; }
3) constexpr R&& base() && noexcept { return std::move(r_); }
4) constexpr const R&& base() const && noexcept { return std::move(r_); }
Parametry
Žádná
Vrácená hodnota
Odkaz na podkladovou oblast, zavolejte ji rg.
Pro 1 &2 se podkladový rozsah vrátí prostřednictvím return rg;
Pro 3 a 4 se podkladový rozsah vrátí prostřednictvím std::move(rg);
begin
Získejte iterátor k prvnímu prvku v zobrazení.
constexpr iterator_t<R> begin();
constexpr auto begin() const requires range<const R>;
Parametry
Žádná
Vrácená hodnota
Iterátor ukazující na první prvek v zobrazení:
data
Získejte ukazatel na první prvek v zobrazení.
constexpr auto data()
requires std::contiguous_iterator<ranges::iterator_t<R>>;
constexpr auto data() const
requires std::contiguous_iterator<ranges::iterator_t<const R>>;
Parametry
Žádná
Vrácená hodnota
Ukazatel na první prvek v zobrazení.
Poznámky
Základní vlastněný rozsah musí splňovat contiguous_range.
empty
Otestujte, jestli je zobrazení prázdné.
constexpr bool empty();
constexpr bool empty() const;
Parametry
Žádná
Vrácená hodnota
Vrátí true , pokud podkladová oblast neobsahuje žádné prvky. V opačném případě vrátí hodnotu false.
end
Získejte sentinel na konci zobrazení.
constexpr sentinel_t<R> end();
constexpr auto end() const requires range<const R>
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<R>;
constexpr auto size() const requires ranges::sized_range<const R>;
Parametry
Žádná
Vrácená hodnota
Počet prvků v zobrazení.
operator=
Přiřaďte (přesuňte) obsah z jiného owning_view obsahu k tomuto obsahu.
owning_view& operator=(owning_view&&) = default;
Parametry
Přiřazení owning_view (přesunutí) k tomuto.
Vrácená hodnota
*this
Poznámky
Nelze owning_view zkopírovat, pouze přesunout.
Příklad: operator=
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
int main()
{
std::vector<int> v1 = {1,2,3};
std::ranges::owning_view<std::vector<int>> ov1{std::move(v1)};
std::vector<int> v2 = {4,5,6};
std::ranges::owning_view<std::vector<int>> ov2{std::move(v2)};
// operator=
ov2 = std::move(ov1);
// ov1 took ownership of v1, so v1 is empty
// ov2 took ownership of v2, so v2 is empty
// ov2 then took ownership of ov1, so ov1 is empty
// ov2 now owns the elements 1, 2, 3
std::cout << std::boolalpha << "v1.empty():" << v1.empty() << " ov1.empty():" << ov1.empty() << '\n'; // v1.empty():true ov1.empty():true
std::cout << "v2.empty():" << v2.empty() << " ov2.size():" << ov2.size() << '\n'; // v2.empty():true ov2.size():3
for (auto e : ov2)
{
std::cout << e << ' '; // 1 2 3
}
}
v1.empty():true ov1.empty():true
v2.empty():true ov2.size():3
1 2 3