keys_view クラス (C++ 標準ライブラリ)
コレクション内の各タプルに似た値への最初のインデックスのビュー。 たとえば、 std::tuple<string, int>の範囲を指定すると、各タプルのすべての string 要素で構成されるビューが作成されます。
keys_view は elements_view<R, 0> のエイリアスであり、 std::map や std::unordered_mapなどの連想コンテナーからキーを表示するのに役立ちます。
構文
template<input_range R>
using keys_view = ranges::elements_view<R, 0>;
テンプレート パラメーター
R
基になる範囲の型。 この型は、 ranges::input_rangeを満たす必要があります。
特性の表示
以下の項目の説明については、 View クラスの特性を参照してください。
| 特徴 | 説明 |
|---|---|
| 範囲アダプター | views::keys |
| 基になる範囲 | input_range以上を満たす必要があります |
| 要素の種類 | 基になる範囲の最初のタプル要素の型と同じです |
| 反復子カテゴリの表示 | random_access_range 基になる範囲が連続している場合は 、それ以外の場合は基になる範囲と同じです |
| サイズ | 基になる範囲が満たされる場合のみ sized_range |
const対応 |
基になる範囲が満たされる場合のみ const-iterable |
| 共通範囲 | 基になる範囲が満たされる場合のみ common_range |
| 借用範囲 | 基になる範囲が満たされる場合のみ borrowed_range |
メンバー
次のメンバー関数の一覧は、 keys_view クラスを参照しています。 これは、 element_view クラス テンプレートのインスタンス化のエイリアスであることを思い出してください。
| メンバー関数 | 説明 |
|---|---|
| コンストラクターC++20 | keys_view を構築します。 |
baseC++20 |
基になる範囲を取得します。 |
beginC++20 |
最初の要素を指す反復子を取得します。 |
endC++20 |
ビューの最後にあるセンチネルを取得します。 |
sizeC++20 |
要素の数を取得します。 基になる範囲は、 sized_rangeを満たす必要があります。 |
継承の対象 view_interface |
説明 |
backC++20 |
最後の要素を取得します。 |
emptyC++20 |
keys_view が空かどうかをテストします。 |
frontC++20 |
最初の要素を取得します。 |
operator[]C++20 |
指定した位置にある要素を取得します。 |
operator boolC++20 |
keys_viewが空でないかどうかをテストします。 |
要件
Header: <ranges> (C++20 以降)
名前空間: std::ranges
コンパイラ オプション: /std:c++20 以降が必要です。
解説
keys_viewで使用できるタプルのような型は、std::tuple、std::pair、およびstd::arrayです。
コンストラクター
keys_viewのインスタンスを構築します。
1) constexpr keys_view(V base);
2) keys_view() requires std::default_initializable<V> = default;
パラメーター
base
基になる範囲。
テンプレート パラメーターの型の詳細については、「 Template パラメーターを参照してください。
戻り値
keys_view のインスタンス。
解説
keys_viewを作成する最善の方法は、keys範囲アダプターを使用することです。 範囲アダプターは、ビュー クラスを作成するための目的の方法です。 独自のカスタム ビューの種類を作成する場合は、ビューの種類が公開されます。
1) 指定したビューから keys_view を作成します。
2) 既定のコンストラクターは空の keys_viewを作成します。
例: keys_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <map>
#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}
};
// Extract all of the keys from the map
for (const std::string& standards : std::views::keys(cpp_standards))
{
std::cout << standards << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
}
std::cout << '\n';
// ========== work with a range of 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 95", 1995},
{"Windows 98", 1998},
{"Windows 1.0", 1985},
{"Windows 2000", 2000}
};
// Another way to call the range adaptor using '|': create an keys_view from each pair
for (const std::string& version : windows | std::views::keys)
{
std::cout << version << ' '; // Windows 1.0 Windows 2.0 Windows 3.0 ...
}
}
C++03 C++11 C++14 C++17 C++98 c++20
Windows 1.0 Windows 2.0 Windows 3.0 Windows 3.1 Windows NT 3.1 Windows 95 Windows NT 4.0 Windows 95 Windows 98 Windows 1.0 Windows 2000
base
基になるビューのコピーを取得します。
// 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
keys_view内の最初の要素を指す反復子を取得します。
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires (Simple_view<V>) // or put another way, requires ranges::range<const V>;
パラメーター
ありません。
戻り値
keys_view 内の最初の要素を指す反復子。
end
の最後にセンチネルを取得します。 keys_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>;
パラメーター
ありません。
戻り値
keys_viewの最後の要素に続く sentinel:
size
要素の数を取得します。
constexpr auto size() requires sized_range<V>
constexpr auto size() const requires sized_range<const V>
パラメーター
ありません。
戻り値
keys_view にある要素の数。
解説
ビューのサイズは、基になる範囲が sized_range、つまり境界付きである場合にのみ使用できます。