namespace std::ranges {
inline namespace /*unspecified*/ {
inline constexpr /*unspecified*/ crend = /*unspecified*/;
}
}
概要
Rangeの先頭の前を指す、読み取り専用逆イテレータもしくは番兵を取得する関数オブジェクト。
効果
部分式E
の型をT
とする。このとき、式ranges::crend(E)
の効果は以下の式と等しい。
E
がlvalueであれば、ranges::rend(static_cast<const T&>(E))
- それ以外の場合、
ranges::rend(static_cast<const T&&>(E))
戻り値
Rangeの先頭の前を指す、読み取り専用逆イテレータもしくは番兵。
カスタマイゼーションポイント
Rangeがconst
な場合についてranges::rend
をカスタマイズすることで、ranges::crend
をカスタマイズできる。
備考
ranges::crend(E)
が有効な式であるとき、ranges::crend(E)
の型S
、ranges::crbegin(E)
の型I
はsentinel_for<S, I>
のモデルである。
例
#include <iostream>
#include <vector>
#include <ranges>
#include <algorithm>
void print(int x)
{
std::cout << x << " ";
}
int main()
{
// コンテナ
{
std::vector<int> v = {1, 2, 3};
decltype(v)::const_reverse_iterator first = std::ranges::crbegin(v);
decltype(v)::const_reverse_iterator last = std::ranges::crend(v);
std::for_each(first, last, print);
}
std::cout << std::endl;
// 組み込み配列
{
int ar[] = {4, 5, 6};
std::reverse_iterator<const int*> first = std::ranges::crbegin(ar);
std::reverse_iterator<const int*> last = std::ranges::crend(ar);
std::for_each(first, last, print);
}
std::cout << std::endl;
// 初期化子リスト
{
std::initializer_list<int> init = {7, 8, 9};
std::reverse_iterator<const int*> first = std::ranges::crbegin(init);
std::reverse_iterator<const int*> last = std::ranges::crend(init);
std::for_each(first, last, print);
}
}
出力
3 2 1
6 5 4
9 8 7
バージョン
言語
- C++20
処理系
- Clang: 13.0.0
- GCC: 10.1.0
- ICC: ?
- Visual C++: 2019 Update 10