std::rend, std::crend

 

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 rend( C& c ) -> decltype(c.rend());	(1)	(C++14 起) (自 C++17 起為 constexpr)
template< class C > auto rend( const C& c ) -> decltype(c.rend());	(2)	(C++14 起) (自 C++17 起為 constexpr)
template< class T, std::size_t N > std::reverse_iterator<T*> rend( T (&array)[N] );	(3)	(C++14 起) (自 C++17 起為 constexpr)
template< class T > std::reverse_iterator<const T*> rend( std::initializer_list<T> il );	(4)	(C++14 起) (自 C++17 起為 constexpr)
template< class C > auto crend( const C& c ) -> decltype(std::rend(c));	(5)	(C++14 起) (自 C++17 起為 constexpr)

返回給定範圍的反向末尾迭代器。

1,2) 返回 c.rend()，它通常是表示 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::end(c)，其中 c 始終被視為 const-qualified (常量限定)。

如果 C 是標準容器，返回一個 C::const_reverse_iterator 物件。

引數

c	-	一個帶有 rend 成員函式的容器或檢視
array	-	任意型別的陣列
il	-	一個 std::initializer_list

返回值

1,2) c.rend()

3) std::reverse_iterator<T*>(array)

4) std::reverse_iterator<const T*>(il.begin())

5) c.rend()

異常

可能丟擲實現定義的異常。

過載

可以為不暴露合適 rend() 成員函式但可迭代的類和列舉提供 rend 的自定義過載。

透過實參依賴查詢找到的 rend 過載可用於自定義 std::ranges::rend 和 std::ranges::crend 的行為。

(C++20 起)

注意

std::initializer_list 的過載是必要的，因為它沒有 rend 成員函式。

示例

執行此程式碼

#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
 
int main()
{
    int a[]{4, 6, -3, 9, 10};
    std::cout << "C-style array `a` backwards: ";
    std::copy(std::rbegin(a), std::rend(a), std::ostream_iterator<int>(std::cout, " "));
 
    auto il = {3, 1, 4};
    std::cout << "\nstd::initializer_list `il` backwards: ";
    std::copy(std::rbegin(il), std::rend(il), std::ostream_iterator<int>(std::cout, " "));
 
    std::vector<int> v{4, 6, -3, 9, 10};
    std::cout << "\nstd::vector `v` backwards: ";
    std::copy(std::rbegin(v), std::rend(v), std::ostream_iterator<int>(std::cout, " "));
    std::cout << '\n';
}

輸出

C-style array `a` backwards: 10 9 -3 6 4
std::initializer_list `il` backwards: 4 1 3
std::vector `v` backwards: 10 9 -3 6 4

參閱

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