namespace std::ranges {
inline namespace /*unspecified*/ {
inline constexpr /*unspecified*/ cbegin = /*unspecified*/;
}
}
概要
Rangeから先頭要素への読み取り専用イテレータを取得する関数オブジェクト。
効果
部分式E
の型をT
とする。このとき、式ranges::cbegin(E)
の効果は以下の式と等しい。
E
がlvalueであれば、ranges::begin(static_cast<const T&>(E))
- それ以外の場合、
ranges::begin(static_cast<const T&&>(E))
戻り値
先頭要素への読み取り専用イテレータ。
カスタマイゼーションポイント
Rangeがconst
な場合についてranges::begin
をカスタマイズすることで、ranges::cbegin
をカスタマイズできる。
備考
ranges::cbegin
の呼び出しが有効な式であるとき、その型はinput_or_output_iterator
のモデルである。
例
#include <iostream>
#include <vector>
#include <ranges>
#include <algorithm>
int main()
{
std::vector<int> v = {1, 2, 3};
decltype(v)::const_iterator first = std::ranges::cbegin(v);
decltype(v)::const_iterator last = std::ranges::cend(v);
std::for_each(first, last, [](const int& x) {
std::cout << x << std::endl;
});
}
出力
1
2
3
バージョン
言語
- C++20
処理系
- Clang: 13.0.0
- GCC: 10.1.0
- ICC: ?
- Visual C++: 2019 Update 10