次の方法で共有

elements_view クラス (C++ 標準ライブラリ)

  • [アーティクル]

範囲内の各タプルに似た値の選択したインデックスにある要素のビュー。 たとえば、 std::tuple<string, int>の範囲を指定すると、各タプルの string 要素で構成されるビューが作成されます。

構文

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

テンプレート パラメーター

N
ビューに対して選択する要素のインデックス。

V
基になる範囲の型。 この型は、 ranges::input_rangeを満たす必要があります。

特性の表示

以下の項目の説明については、 View クラスの特性を参照してください。

特徴 説明
範囲アダプター views::elements
基になる範囲 input_range以上を満たす必要があります
要素の種類 インデックス付きタプル要素の型と同じ
反復子カテゴリの表示 forward_range、 bidirectional_range、または random_access_range
サイズ 基になる範囲が満たされる場合のみ sized_range
const対応 基になる範囲が満たされる場合のみ const-iterable
共通範囲 基になる範囲が満たされる場合のみ common_range
借用範囲 基になる範囲が満たされる場合のみ borrowed_range

メンバー

メンバー関数 説明
コンストラクターC++20 elements_view を構築します。
baseC++20 基になる範囲を取得します。
beginC++20 最初の要素を指す反復子を取得します。
endC++20 ビューの最後にあるセンチネルを取得します。
sizeC++20 このビューの要素の数を取得します。 基になる範囲は、 sized_rangeを満たす必要があります。
継承の対象 view_interface 説明
backC++20 最後の要素を取得します。
emptyC++20 elements_view が空かどうかをテストします。
frontC++20 最初の要素を取得します。
operator[]C++20 指定した位置にある要素を取得します。
operator boolC++20 elements_viewが空でないかどうかをテストします。

要件

Header: <ranges> (C++20 以降)

名前空間: std::ranges

コンパイラ オプション: /std:c++20 以降が必要です。

解説

elements_viewで使用できるタプルのような型は、std::tuple、std::pair、およびstd::arrayです。

コンストラクター

elements_viewのインスタンスを構築します。

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

パラメーター

base
基になる範囲。

テンプレート パラメーターの型の詳細については、「 Template パラメーターを参照してください。

戻り値

elements_view インスタンス。

解説

elements_viewを作成する最善の方法は、elements範囲アダプターを使用することです。 範囲アダプターは、ビュー クラスを作成するための目的の方法です。 独自のカスタム ビューの種類を作成する場合は、ビューの種類が公開されます。

1) 指定したビューから elements_view を作成します。
2) 既定では、 elements_viewを構築します。

例: 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

基になる範囲のコピーを取得します。

// 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() &&;

パラメーター

ありません。

戻り値

基になる範囲。

begin

elements_view内の最初の要素を指す反復子を取得します。

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

パラメーター

ありません。

戻り値

elements_view 内の最初の要素を指す反復子。

要素 10、20、30 を持つベクトルの図。最初の要素には 10 が含まれており、begin() というラベルが付いています。最後の要素には 30 が含まれており、

end

の最後にセンチネルを取得します。 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>;

パラメーター

ありません。

戻り値

elements_viewの最後の要素に続く sentinel:

要素 10、20、30 を持つベクトルの図。最初の要素には 10 が含まれており、begin() というラベルが付いています。最後の要素には 30 が含まれており、

size

ビュー内の要素の数を取得します。

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

パラメーター

ありません。

戻り値

elements_view にある要素の数。

解説

ビューのサイズは、基になる範囲が sized_range、つまり境界付きである場合にのみ使用できます。

関連項目

keys_view
values_view
クラスの表示
<ranges>