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 建構 。 |
base C++20 |
取得基礎範圍。 |
begin C++20 |
取得第一個專案的反覆運算器。 |
end C++20 |
取得 結尾的 reverse_view sentinel。 |
size C++20 |
取得項目數目。 |
繼承自 view_interface |
說明 |
back C++20 |
取得最後一個專案。 |
empty C++20 |
測試 是否 reverse_view 為空白。 |
front C++20 |
取得第一個專案。 |
operator[] C++20 |
取得位於指定位置的專案。 |
operator bool C++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
反覆運算器。
備註
在第一次呼叫 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_view
sentinel。
備註
針對 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
、或換句話說,限定時,才能使用檢視的大小。