std::rbegin, std::crbegin

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

迭代器庫

迭代器概念
間接可讀 (indirectly_readable) (C++20) 間接可寫 (indirectly_writable) (C++20) 弱可遞增 (weakly_incrementable) (C++20) 可遞增 (incrementable) (C++20) 類整數 (is-integer-like) 類有符號整數 (is-signed-integer-like) (C++20)(C++20)	哨兵 (sentinel_for) (C++20) 有大小哨兵 (sized_sentinel_for) (C++20) 輸入迭代器 (input_iterator) (C++20) 輸出迭代器 (output_iterator) (C++20) 輸入或輸出迭代器 (input_or_output_iterator) (C++20)	前向迭代器 (forward_iterator) (C++20) 雙向迭代器 (bidirectional_iterator) (C++20) 隨機訪問迭代器 (random_access_iterator) (C++20) 連續迭代器 (contiguous_iterator) (C++20)
迭代器原語
input_iterator_tag (輸入迭代器標籤)output_iterator_tag (輸出迭代器標籤)forward_iterator_tag (前向迭代器標籤)bidirectional_iterator_tag (雙向迭代器標籤)random_access_iterator_tag (隨機訪問迭代器標籤)contiguous_iterator_tag (連續迭代器標籤) (C++20)	iter_value_t (迭代器值型別)iter_difference_t (迭代器差值型別)iter_reference_t (迭代器引用型別)iter_const_reference_t (迭代器常量引用型別)iter_rvalue_reference_t (迭代器右值引用型別)iter_common_reference_t (迭代器通用引用型別) (C++20)(C++20)(C++20)(C++23)(C++20)(C++20)	迭代器 (iterator) (C++17 中已棄用) 迭代器特性 (iterator_traits) 可遞增特性 (incrementable_traits) (C++20) 間接可讀特性 (indirectly_readable_traits) (C++20)
演算法概念與工具
間接可呼叫概念
間接一元可呼叫 (indirectly_unary_invocable)間接正則一元可呼叫 (indirectly_regular_unary_invocable) (C++20)(C++20)	間接一元謂詞 (indirect_unary_predicate) (C++20) 間接二元謂詞 (indirect_binary_predicate) (C++20)	間接等價關係 (indirect_equivalence_relation) (C++20) 間接嚴格弱序 (indirect_strict_weak_order) (C++20)
常用演算法要求
間接可移動 (indirectly_movable) (C++20) 間接可移動可儲存 (indirectly_movable_storable) (C++20) 間接可複製 (indirectly_copyable) (C++20)	間接可複製可儲存 (indirectly_copyable_storable) (C++20)   間接可交換 (indirectly_swappable) (C++20) 間接可比較 (indirectly_comparable) (C++20)	可置換 (permutable) (C++20) 可合併 (mergeable) (C++20) 可排序 (sortable) (C++20)
工具
間接結果型別 (indirect_result_t) (C++20)	投影 (projected) (C++20)	投影值型別 (projected_value_t) (C++26)
迭代器介面卡
反向迭代器 (reverse_iterator) 建立反向迭代器 (make_reverse_iterator) (C++14) 移動迭代器 (move_iterator) (C++11) 建立移動迭代器 (make_move_iterator) (C++11) 預設哨兵型別 (default_sentinel_t)預設哨兵 (default_sentinel) (C++20)(C++20) 不可達哨兵型別 (unreachable_sentinel_t)不可達哨兵 (unreachable_sentinel) (C++20)(C++20)	前插入迭代器 (front_insert_iterator) 後插入迭代器 (back_insert_iterator) 插入器 (inserter) 插入迭代器 (insert_iterator) 前插入器 (front_inserter) 後插入器 (back_inserter) 移動哨兵 (move_sentinel) (C++20)	通用迭代器 (common_iterator) (C++20) 計數迭代器 (counted_iterator) (C++20) 基本常量迭代器 (basic_const_iterator) (C++23) 常量迭代器 (const_iterator) (C++23) 常量哨兵 (const_sentinel) (C++23) 建立常量迭代器 (make_const_iterator) (C++23) 建立常量哨兵 (make_const_sentinel) (C++23)
流迭代器 輸入流迭代器 (istream_iterator)    輸出流迭代器 (ostream_iterator) 輸入流緩衝區迭代器 (istreambuf_iterator) 輸出流緩衝區迭代器 (ostreambuf_iterator)	迭代器定製點 ranges::iter_move (範圍::迭代器移動) (C++20) ranges::iter_swap (範圍::迭代器交換) (C++20)
迭代器操作 前進 (advance) 距離 (distance) 前一個 (prev) (C++11)   下一個 (next) (C++11) ranges::advance (範圍::前進) (C++20) ranges::distance (範圍::距離) (C++20) ranges::prev (範圍::前一個) (C++20) ranges::next (範圍::下一個) (C++20)	範圍訪問 begin (開始)cbegin (常量開始) (C++11)(C++14) rbegin (反向開始)crbegin (常量反向開始) (C++14)(C++14)   end (結束)cend (常量結束) (C++11)(C++14) rend (反向結束)crend (常量反向結束) (C++14)(C++14)   size (大小)ssize (有符號大小) (C++17)(C++20) empty (為空) (C++17) data (資料) (C++17)

 

定義於標頭檔案 <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 是標準容器，則返回 C::reverse_iterator 物件。

2) 若 C 是標準容器，則返回 C::const_reverse_iterator 物件。

3) 返回一個 std::reverse_iterator<T*> 物件，指向 array 的反向起始。

4) 返回一個 std::reverse_iterator<const T*> 物件，指向 il 的反向起始。

5) 返回 std::rbegin(c)，其中 c 總是被視為 const-qualified (常量限定)。

若 C 是標準容器，則返回 C::const_reverse_iterator 物件。

引數

c	-	帶有 rbegin 成員函式的容器或檢視
array	-	任意型別的陣列
il	-	一個 std::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); // the type of “vi” is std::vector<int>::reverse_iterator
    std::cout << "*vi = " << *vi << '\n';
 
    *std::rbegin(v) = 42; // OK: after assignment v[2] == 42
//  *std::crbegin(v) = 13; // error: the location is read-only
 
    int a[] = {-5, 10, 15};
    auto ai = std::rbegin(a); // the type of “ai” is std::reverse_iterator<int*>
    std::cout << "*ai = " << *ai << '\n';
 
    auto il = {3, 1, 4};
    // the type of “it” below is 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

參閱

begin (開始)cbegin (常量開始) (C++11)(C++14)	返回指向容器或陣列開頭的迭代器 (函式模板)
end (結束)cend (常量結束) (C++11)(C++14)	返回指向容器或陣列末尾的迭代器 (函式模板)
rend (反向結束)crend (常量反向結束) (C++14)	返回容器或陣列的反向結束迭代器 (函式模板)
ranges::rbegin (範圍::反向開始) (C++20)	返回指向範圍的反向迭代器 (定製點物件)
ranges::crbegin (範圍::常量反向開始) (C++20)	返回只讀範圍的反向迭代器 (定製點物件)