ref_view クラス (C++ 標準ライブラリ)
別の範囲に属する要素を参照するビュー。
構文
template<std::ranges::range R>
requires std::is_object_v<R>
class ref_view : public ranges::view_interface<ref_view<R>>;
テンプレート パラメーター
R
参照する範囲。
メンバー
| メンバー関数 | 説明 |
|---|---|
| コンストラクターC++20 | ref_view を構築します。 |
baseC++20 |
基になる範囲への参照を取得します。 |
beginC++20 |
最初の要素を指す反復子を取得します。 |
dataC++20 |
参照範囲の最初の要素へのポインターを取得します。 |
emptyC++20 |
この ref_view が空かどうかをテストします。 |
endC++20 |
この ref_viewの最後にセンチネルを取得します。 |
sizeC++20 |
要素の数を取得します。 基になる範囲は、 sized_rangeを満たす必要があります。 |
継承の対象 view_interface |
説明 |
backC++20 |
最後の要素を取得します。 |
frontC++20 |
最初の要素を取得します。 |
operator[]C++20 |
指定した位置にある要素を取得します。 |
operator boolC++20 |
この ref_view が空でないかどうかをテストします。 |
特性の表示
以下の項目の説明については、 View クラスの特性を参照してください。
| 特徴 | 説明 |
|---|---|
| 範囲アダプター | views::all または views::common |
| 基になる範囲 | 満たす必要があります input_range |
| 要素の種類 | 基になる範囲と同じ |
| 反復子カテゴリの表示 | 基になる範囲と同じ |
| サイズ | 基になる範囲が満たされる場合のみ sized_range |
const対応 |
はい |
| 共通範囲 | 基になる範囲が満たされる場合のみ common_range |
| 借用範囲 | はい |
要件
Header: <ranges> (C++20 以降)
名前空間: std::ranges
コンパイラ オプション: /std:c++20 以降が必要です。
コンストラクター
のインスタンスを構築する ref_view
// construct a ref_view from a range
template<different-from<ref_view> R>
constexpr ref_view(R&& rg);
パラメーター
rg
参照する範囲。
テンプレート パラメーターの型の詳細については、「 Template パラメーターを参照してください。
戻り値
ref_view のインスタンス。
解説
ref_viewを作成する最善の方法は、views::all範囲アダプターを使用することです。 範囲アダプターは、ビュー クラスを作成するための目的の方法です。 独自のカスタム ビューの種類を作成する場合は、ビューの種類が公開されます。
ref_viewは、コンテナーをビューに変換する場合に便利です。 たとえば、 ref_view を使用して vector をビューに変換できるため、ベクターの要素を渡すコストが低くなります。
例: ref_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
int main()
{
std::vector<int> v = {1,2,3};
auto refView = std::views::all(v);
std::cout << &refView[1] << " : " << &v[1]; // outputs two identical memory addresses, e.g. 00000239AFAFDF90 : 00000239AFAFDF90
refView[0] = 10; // modifies v[0]
std::cout << "\n" << v[0]; // 10
}
00000239AFAFDF90 : 00000239AFAFDF90
10
base
基になる範囲のコピーを取得します。
constexpr R& base() const;
パラメーター
ありません。
戻り値
基になる範囲。
begin
ref_view内の最初の要素を指す反復子を取得します。
constexpr iterator_t<R> begin() const;
パラメーター
ありません。
戻り値
この ref_viewの最初の要素を指す反復子。
data
この ref_viewの最初の要素へのポインターを取得します。 範囲内の要素は連続している必要があります。
constexpr auto data() const requires contiguous_range<R>;
パラメーター
ありません。
戻り値
最初の要素へのポインター。
empty
この ref_view が空かどうかをテストします。
constexpr bool empty() const
パラメーター
ありません。
戻り値
ref_viewに要素が含trueを返します。 それ以外の場合は false。
end
この ref_viewの最後にセンチネルを取得します。
constexpr sentinel_t<R> end() const
戻り値
この ref_viewの最後の要素に続く sentinel:
size
要素の数を取得します。
constexpr auto size() const requires sized_range<R>
パラメーター
ありません。
戻り値
ref_view にある要素の数。