elements_view osztály (C++ standard kódtár)

A kijelölt index elemeinek nézete a tartomány minden rekordszerű értékében. Ha például egy tartományt std::tuple<string, int>ad meg, hozzon létre egy nézetet, amely az string egyes elemekből áll.

Szemantika

template<input_range V, size_t N>
class elements_view : public view_interface<elements_view<V, N>>;

Sablonparaméterek

N
A nézethez kijelölendő elem indexe.

V
Az alapul szolgáló tartomány típusa. Ennek a típusnak meg kell felelnie ranges::input_range.

Jellemzők megtekintése

Az alábbi bejegyzések leírásáért lásd: Osztályjellemzők megtekintése

Jellemző	Leírás
Tartomány adaptere	views::elements
Mögöttes tartomány	Meg kell felelnie vagy magasabbnak kell lennie input_range
Elem típusa	Ugyanaz, mint az indexelt rekordelem típusa
Iterátor kategória megtekintése	forward_range, bidirectional_range vagy random_access_range
Méretű	Csak akkor, ha a mögöttes tartomány megfelel sized_range
Iterable const	Csak akkor, ha a mögöttes tartomány megfelel const-iterable
Gyakori tartomány	Csak akkor, ha a mögöttes tartomány megfelel common_range
Kölcsönzött tartomány	Csak akkor, ha a mögöttes tartomány megfelel borrowed_range

Tagok

Tagfüggvények	Leírás
KonstruktorokC++20	Hozzon létre egy elements_view.
base C++20	Szerezze be a mögöttes tartományt.
begin C++20	Iterátor lekérése az első elemhez.
end C++20	Kérje le a sentinelt a nézet végén.
size C++20	A nézetben található elemek számának lekérése. A mögöttes tartománynak meg kell felelnie sized_range.
Öröklődve innen: view_interface	Leírás
back C++20	Az utolsó elem lekérése.
empty C++20	Ellenőrizze, hogy üres-e elements_view .
front C++20	Az első elem lekérése.
operator[] C++20	Kérje le az elemet a megadott pozícióba.
operator bool C++20	Ellenőrizze, hogy nem elements_view üres-e.

Követelmények

Fejléc:<ranges> (A C++20 óta)

Névtér:std::ranges

Fordítási lehetőség:/std:c++20 vagy újabb verzióra van szükség.

Megjegyzések

A használható típusok elements_view a következők std::tuple: , std::pairés std::array.

Konstruktorok

Hozzon létre egy példányt elements_view.

1) constexpr elements_view(V base);
2) elements_view() requires std::default_initializable<V> = default;

Paraméterek

base
Az alapul szolgáló tartomány.

A sablonparaméter típusával kapcsolatos információkért tekintse meg a sablon paramétereit.

Visszaadott érték

Egy elements_view példány.

Megjegyzések

A legjobb módszer a tartományadafóorral történő létrehozásra elements_viewelements . A nézetosztályok létrehozásának célja a tartományadabrátorok. A nézettípusok akkor jelennek meg, ha saját egyéni nézettípust szeretne létrehozni.

1) Hozzon létre egy elements_view adott nézetet.
2) Alapértelmezés szerint hozzon létre egy elements_view.

Példa: elements_view

// requires /std:c++20 or later
#include <array>
#include <iostream>
#include <map>
#include <ranges>
#include <vector>
#include <string>
#include <utility>

int main()
{
    // ========== work with a std::map

    std::map<std::string, int> cpp_standards
    {
        {"C++98", 1988},
        {"C++03", 2003},
        {"C++11", 2011},
        {"C++14", 2014},
        {"C++17", 2017},
        {"C++20", 2020}
    };

    // create an elements_view of all the string elements (<1>) from each tuple
    for (int const year : std::views::elements<1>(cpp_standards))
    {
        std::cout << year << ' '; // 2003 2011 2014 2017 1988 2020
    }

    std::cout << '\n';

    // Another way to call the range adaptor using pipe (|) syntax
    for (auto&& name : cpp_standards | std::views::elements<0>)
    {
        std::cout << name << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
    }
    std::cout << '\n';

    // ========== working with arrays

    std::array<std::array<int, 4>, 3> arr = { {{0,1,2,3}, {4,5,6,7}, {8,9,10,11}} };
    for (int& fourth : arr | std::views::elements<3>)
    {
        std::cout << fourth << ' '; // 3 7 11
    }
    std::cout << '\n';

    // ========== work with a std::pair

    std::vector<std::pair<std::string, int>> windows
    {
        {"Windows 1.0", 1985},
        {"Windows 2.0", 1987},
        {"Windows 3.0", 1990},
        {"Windows 3.1", 1992},
        {"Windows NT 3.1", 1993},
        {"Windows 95", 1995},
        {"Windows NT 4.0", 1996},
        {"Windows 98", 1998},
        {"Windows 2000", 2000}
    };

    for (int year : std::views::elements<1>(windows))
    {
        std::cout << year << ' '; // 1985 1987 1990 1992 1993 1995 1996 1998 2000
    }
}

2003 2011 2014 2017 1988 2020
C++03 C++11 C++14 C++17 C++98 c++20
3 7 11
1985 1987 1990 1992 1993 1995 1996 1998 2000

base

Lekéri a mögöttes tartomány másolatát.

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

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

Paraméterek

Nincs.

Visszaadott érték

Az alapul szolgáló tartomány.

begin

Iterátor lekérése a elements_view.

1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires range<const V>;

Paraméterek

Nincs.

Visszaadott érték

Egy iterátor, amely a elements_view.

end

A sentinel lekérése a elements_view

1) constexpr auto end() requires (!Simple_view<V> && !ranges::common_range<V>);
2) constexpr auto end() requires (!Simple_view<V> && ranges::common_range<V>);
3) constexpr auto end() const requires ranges::range<const V>;
4) constexpr auto end() const requires ranges::common_range<const V>;

Paraméterek

Nincs.

Visszaadott érték

A következő elem utolsó elemét elements_viewkövető sentinel:

size

A nézet elemeinek számának lekérése.

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

Paraméterek

Nincs.

Visszaadott érték

elements_viewA .

Megjegyzések

A nézet mérete csak akkor érhető el, ha az alapul szolgáló tartomány sized_rangeegy vagy más szóval határolókeret.

Lásd még

keys_view
values_view
Osztályok megtekintése
<ranges>