共用方式為


reverse_view class (C++標準連結庫)

以反向順序檢視範圍的專案。

語法

template<ranges::view V>
requires ranges::bidirectional_range<V>
class reverse_view : public ranges::view_interface<reverse_view<V>>;

範本參數

V
基礎檢視的類型。
這個類型必須滿足 ranges::bidirectional_range

檢視特性

如需下列專案的描述,請參閱 檢視類別特性

特性 描述
範圍配接器 views::reverse
基礎範圍 必須滿足 bidirectional_range 最多 random_access_range
項目類型 與基礎範圍相同
檢視反覆運算器類別 與基礎範圍相同
大小 只有在基礎範圍滿足時才 sized_range
const-iterable 只有當基礎範圍是 common_view 且滿足時 const-iterable
通用範圍 Yes
借用範圍 只有在基礎範圍滿足時才 borrowed_range

成員

成員函式 說明
建構函式C++20 reverse_view建構 。
baseC++20 取得基礎範圍。
beginC++20 取得第一個專案的反覆運算器。
endC++20 取得 結尾的 reverse_viewsentinel。
sizeC++20 取得項目數目。
繼承自 view_interface 說明
backC++20 取得最後一個專案。
emptyC++20 測試 是否 reverse_view 為空白。
frontC++20 取得第一個專案。
operator[]C++20 取得位於指定位置的專案。
operator boolC++20 測試是否不是空的 reverse_view

需求

標頭: <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
要提供 反轉檢視的檢視。

如需範本參數類型的相關信息,請參閱 範本參數

傳回值

基礎範圍的檢視,以反向順序排列。

備註

建立 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反覆運算器。

具有元素 10、20 和 30 的向量圖片。第一個元素包含 10,且標示為 begin()。最後一個專案包含 30 個,且標示為「最後一個專案」。最後一個專案後面的虛方塊表示 sentinel 且標示為 end()。

備註

在第一次呼叫 begin()之後,後續呼叫會以常數時間執行 O(1),不論 中的 reverse_view元素數目為何。 這具有含意,因為 reverse_view 會快取的值 last ,以便從 重複 begin傳回它。 這表示在修改基礎容器之後,您不應該重複使用檢視。 如果修改基礎範圍,請產生成本低廉的新檢視。

2) 基礎檢視必須滿足 common_range,這表示基礎檢視必須具有相同的開始和結束反覆運算器類型。
3) 基礎檢視必須滿足 common_range ,const 檢視才能逐一 const reverse_view查看 。

end

在結尾取得 sentinel reverse_view

1) constexpr reverse_iterator<iterator_t<V>> end();
2) constexpr auto end() const requires common_range<const V>;

參數

無。

傳回值

在 中最後一個項目之後的 reverse_viewsentinel。

具有元素 10、20 和 30 的向量圖片。第一個元素包含 10,且標示為 begin()。最後一個專案包含 30 個,且標示為「最後一個專案」。最後一個專案後面的虛方塊表示 sentinel 且標示為 end()。

備註

針對 2,基礎檢視必須滿足 common_range const 檢視,這表示基礎檢視必須具有相同的開始和結束反覆運算器類型。

size

取得項目數目。

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

參數

無。

傳回值

reverse_view 中的項目數。

備註

只有當基礎範圍是 sized_range、或換句話說,限定時,才能使用檢視的大小。

另請參閱

<ranges>
reverse 範圍配接器
檢視類別