reverse_view クラス (C++ 標準ライブラリ)
範囲の要素を逆順に表示するビュー。
構文
template<ranges::view V>
requires ranges::bidirectional_range<V>
class reverse_view : public ranges::view_interface<reverse_view<V>>;
テンプレート パラメーター
V
基になるビューの型。
この型は、 ranges::bidirectional_rangeを満たす必要があります。
特性の表示
以下の項目の説明については、 View クラスの特性を参照してください。
| 特徴 | 説明 |
|---|---|
| 範囲アダプター | views::reverse |
| 基になる範囲 | まで bidirectional_range を満たす必要があります random_access_range |
| 要素の種類 | 基になる範囲と同じ |
| 反復子カテゴリの表示 | 基になる範囲と同じ |
| サイズ | 基になる範囲が満たされる場合のみ sized_range |
const対応 |
基になる範囲が common_view であり、満たす場合にのみ const-iterable |
| 共通範囲 | はい |
| 借用範囲 | 基になる範囲が満たされる場合のみ borrowed_range |
メンバー
| メンバー関数 | 説明 |
|---|---|
| コンストラクターC++20 | reverse_view を構築します。 |
baseC++20 |
基になる範囲を取得します。 |
beginC++20 |
最初の要素を指す反復子を取得します。 |
endC++20 |
reverse_viewの最後に sentinel を取得します。 |
sizeC++20 |
要素の数を取得します。 |
継承の対象 view_interface |
説明 |
backC++20 |
最後の要素を取得します。 |
emptyC++20 |
reverse_view が空かどうかをテストします。 |
frontC++20 |
最初の要素を取得します。 |
operator[]C++20 |
指定した位置にある要素を取得します。 |
operator boolC++20 |
reverse_viewが空でないかどうかをテストします。 |
要件
Header: <ranges> (C++20 以降)
名前空間: std::ranges
コンパイラ オプション: /std:c++20 以降が必要です。
コンストラクター
双方向ビューから reverse_view のインスタンスを構築します。
1) reverse_view() requires default_initializable<V> = default; // default-constructs the underlying view
2) constexpr explicit reverse_view(V rg); // initializes the underlying view via std::move(r)
パラメーター
rg
反転ビューを提供するビュー。
テンプレート パラメーターの型の詳細については、「 Template パラメーターを参照してください。
戻り値
基になる範囲のビュー (逆順)。
解説
reverse_viewを作成する最善の方法は、views::reverse範囲アダプターを使用することです。 範囲アダプターは、ビュー クラスを作成するための目的の方法です。 独自のカスタム ビューの種類を作成する場合は、ビューの種類が公開されます。
1) 既定のコンストラクターは、 reverse_viewを既定で初期化します。
2) 指定したビューから reverse_view を作成します。
例: reverse_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
int main()
{
std::vector<int> v{0, 1, 2, 3, -4, 5, 6};
auto rv = v | std::views::reverse;
for (auto e : rv) // 6 5 -4 3 2 1 0
{
std::cout << e << ' ';
}
}
6 5 -4 3 2 1 0
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
reverse_view内の最初の要素を指す反復子を取得します。
1) constexpr reverse_iterator<iterator_t<V>> begin();
2) constexpr reverse_iterator<iterator_t<V>> begin() requires common_range<V>;
3) constexpr auto begin() const requires common_range<const V>;
パラメーター
ありません。
戻り値
reverse_view 内の最初の要素を指す反復子。
解説
begin()の最初の呼び出しの後、後続の呼び出しは、reverse_view内の要素の数に関係なく、定数時間 O(1) で実行されます。 これは、reverse_viewがbeginから繰り返し返し返すことができるようにlastの値をキャッシュするためです。 つまり、基になるコンテナーが変更された後は、ビューを再利用しないでください。 基になる範囲が変更された場合は、新しいビューを生成します。これは低コストです。
2) 基になるビューは、 common_rangeを満たす必要があります。つまり、基になるビューの開始反復子と終了反復子の型は同じである必要があります。
3) 基になるビューは、const ビューがconst reverse_viewを反復処理するためのcommon_rangeを満たす必要があります。
end
の最後にセンチネルを取得します。 reverse_view
1) constexpr reverse_iterator<iterator_t<V>> end();
2) constexpr auto end() const requires common_range<const V>;
パラメーター
ありません。
戻り値
reverse_viewの最後の要素に続くセンチネル。
解説
2 の場合、基になるビューは const ビューの common_range を満たす必要があります。つまり、基になるビューの開始反復子と終了反復子の型は同じである必要があります。
size
要素の数を取得します。
constexpr auto size() requires ranges::sized_range<V>;
constexpr auto size() const requires ranges::sized_range<const V>;
パラメーター
ありません。
戻り値
reverse_view にある要素の数。
解説
ビューのサイズは、基になる範囲が sized_range、つまり境界付きである場合にのみ使用できます。