名前空間
変種
操作

std::rbegin, std::crbegin

提供: cppreference.com
< cpp‎ | iterator
 
 
イテレータライブラリ
イテレータコンセプト
イテレータプリミティブ
アルゴリズムのコンセプトとユーティリティ
間接呼び出し可能コンセプト
共通アルゴリズム要件
ユーティリティ
イテレータアダプタ
ストリームイテレータ
イテレータのカスタマイゼーションポイント
イテレータ操作
(C++11)
(C++11)
範囲アクセス
(C++11)(C++14)
(C++11)(C++14)
(C++17)(C++20)
rbegincrbegin
(C++14)(C++14)
(C++14)(C++14)
(C++17)
(C++17)
 
ヘッダ <iterator> で定義
(1)
template< class C >
auto rbegin( C& c ) -> decltype(c.rbegin());
(C++14以上)
(C++17未満)
template< class C >
constexpr auto rbegin( C& c ) -> decltype(c.rbegin());
(C++17以上)
(1)
template< class C >
auto rbegin( const C& c ) -> decltype(c.rbegin());
(C++14以上)
(C++17未満)
template< class C >
constexpr auto rbegin( const C& c ) -> decltype(c.rbegin());
(C++17以上)
(2)
template< class T, size_t N >
reverse_iterator<T*> rbegin( T (&array)[N] );
(C++14以上)
(C++17未満)
template< class T, size_t N >
constexpr reverse_iterator<T*> rbegin( T (&array)[N] );
(C++17以上)
(3)
template< class C >
auto crbegin( const C& c ) -> decltype(std::rbegin(c));
(C++14以上)
(C++17未満)
template< class C >
constexpr auto crbegin( const C& c ) -> decltype(std::rbegin(c));
(C++17以上)

指定されたコンテナ c または配列 array の逆の先頭を指すイテレータを返します。

1) コンテナ c の逆の先頭を指す const 修飾されたまたはされていないイテレータを返します。
2) 配列 array の逆の先頭を指す std::reverse_iterator<T*> を返します。
3) コンテナ c の逆の先頭を指す const 修飾されたイテレータを返します。

range-rbegin-rend.svg

目次

[編集] 引数

c - メンバ関数 rbegin を持つコンテナ
array - 任意の型の配列

[編集] 戻り値

c または array の逆の先頭を指すイテレータ。

[編集] ノート

<iterator> がインクルードされた場合に加えて <array><deque><forward_list><list><map><regex><set><span> (C++20以上)<string><string_view> (C++17以上)<unordered_map><unordered_set><vector> のいずれかのヘッダがインクルードされた場合も、 std::rbegin および std::crbegin が利用可能になることが保証されています。

[編集] オーバーロード

適切な rbegin() メンバ関数を持たないけれどもイテレート可能なクラスに対して、 rbegin のカスタムオーバーロードを提供しても構いません。 以下のオーバーロードは標準ライブラリによってすでに提供されています。

std::rbegin の特殊化
(関数) [edit]

[編集]

#include <iostream>
#include <vector>
#include <iterator>
 
int main() 
{
    std::vector<int> v = { 3, 1, 4 };
    auto vi = std::rbegin(v);
    std::cout << *vi << '\n'; 
 
    int a[] = { -5, 10, 15 };
    auto ai = std::rbegin(a);
    std::cout << *ai << '\n';
}

出力:

4
15

[編集] 関連項目

(C++11)(C++14)
コンテナまたは配列の先頭を指すイテレータを返します
(関数) [edit]
(C++11)(C++14)
コンテナまたは配列の終端を指すイテレータを返します
(関数) [edit]
(C++14)
コンテナまたは配列の終端を指す逆イテレータを返します
(関数) [edit]