std::rbegin, std::crbegin

出自cppreference.com
< cpp‎ | iterator
 
C++
 
迭代器庫
迭代器概念
迭代器原語
演算法概念與工具
間接可調用概念
常用演算法要求
(C++20)
(C++20)
(C++20)
工具
(C++20)
迭代器適配器
範圍訪問
(C++11)(C++14)
rbegincrbegin
(C++14)(C++14)  
(C++11)(C++14)
(C++14)(C++14)  
(C++17)(C++20)
(C++17)
(C++17)
 
{{dcl rev multi|num=3
在標頭 <array> 定義
在標頭 <deque> 定義
在標頭 <flat_map> 定義
在標頭 <flat_set> 定義
在標頭 <forward_list> 定義
在標頭 <inplace_vector> 定義
在標頭 <iterator> 定義
在標頭 <list> 定義
在標頭 <map> 定義
在標頭 <regex> 定義
在標頭 <set> 定義
在標頭 <span> 定義
在標頭 <string> 定義
在標頭 <string_view> 定義
在標頭 <unordered_map> 定義
在標頭 <unordered_set> 定義
在標頭 <vector> 定義
template< class C >
auto rbegin( C& c ) -> decltype(c.rbegin());
 (1) (C++14 起)
(C++17 起為 constexpr)
template< class C >
auto rbegin( const C& c ) -> decltype(c.rbegin());
 (2) (C++14 起)
(C++17 起為 constexpr)
template< class T, std::size_t N >
std::reverse_iterator<T*> rbegin( T (&array)[N] );
 (3) (C++14 起)
(C++17 起為 constexpr)
template< class T >
std::reverse_iterator<const T*> rbegin( std::initializer_list<T> il );
 (4) (C++14 起)
(C++17 起為 constexpr)
template< class C >
auto crbegin( const C& c ) -> decltype(std::rbegin(c));
 (5) (C++14 起)
(C++17 起為 constexpr)

返回指向給定範圍的逆向起始的迭代器。

1,2) 返回 c.rbegin()，它通常是指向 c 所代表的序列逆向起始的迭代器。
1) 如果 C 是標準容器 (Container) ，那麼就會返回 C::reverse_iterator 對象。
2) 如果 C 是標準容器 (Container) ，那麼就會返回 C::const_reverse_iterator 對象。
3) 返回指向 array 的逆向起始的 std::reverse_iterator<T*> 對象。
4) 返回指向 il 的逆向起始的 std::reverse_iterator<const T*> 對象。
5) 返回 std::begin(c)，這裡 c 始終被視為 const 限定。
如果 C 是標準容器 (Container) ，那麼就會返回 C::const_reverse_iterator 對象。

range-rbegin-rend.svg

目錄

[編輯] 參數

c - 擁有 rbegin 方法的容器或視圖
array - 任意類型的數組
il - initializer_list

[編輯] 返回值

1,2) c.rbegin()
3) std::reverse_iterator<T*>(array + N)
4) std::reverse_iterator<const T*>(il.end())
5) c.rbegin()

[編輯] 異常

可能會拋出由實現定義的異常。

[編輯] 重載

可以為未暴露適合的 rbegin() 成員函數的類或枚舉提供 rbegin 的自定義重載，從而能迭代它。

實參依賴查找找到的 rbegin 重載能用於定製 std::ranges::rbegin 與 std::ranges::crbegin 的行為。

(C++20 起)

[編輯] 註解

需要針對 std::initializer_list 的重載，因為它沒有成員函數 rbegin。

[編輯] 示例

運行此代碼
#include <iostream>
#include <iterator>
#include <vector>
 
int main()
{
    std::vector<int> v = {3, 1, 4};
    auto vi = std::rbegin(v); // “vi” 的类型是 std::vector<int>::reverse_iterator
    std::cout << "*vi = " << *vi << '\n';
 
    *std::rbegin(v) = 42; // OK：赋值后 v[2] == 42
//  *std::crbegin(v) = 13; // 错误：此位置只读
 
    int a[] = {-5, 10, 15};
    auto ai = std::rbegin(a); // “ai” 的类型是 std::reverse_iterator<int*>
    std::cout << "*ai = " << *ai << '\n';
 
    auto il = {3, 1, 4};
    // 下面的 “it” 的类型是 std::reverse_iterator<int const*>:
    for (auto it = std::rbegin(il); it != std::rend(il); ++it)
        std::cout << *it << ' ';
    std::cout << '\n';
}

輸出： 

*vi = 4
*ai = 15
4 1 3

[編輯] 參閱

(C++11)(C++14)
 返回指向容器或數組起始的迭代器
(函數模板) [編輯]
(C++11)(C++14)
 返回指向容器或數組結尾的迭代器
(函數模板) [編輯]
(C++14)
 返回容器或數組的逆向尾迭代器
(函數模板) [編輯]
(C++20)
 返回指向範圍的逆向迭代器
(定製點對象) [編輯]
(C++20)
 返回指向只讀範圍的逆向迭代器
(定製點對象) [編輯]
取自「https://zh.cppreference.com/mwiki/index.php?title=cpp/iterator/rbegin&oldid=95493」