namespace std::ranges {
template<view V>
class take_view : public view_interface<take_view<V>> { …… }; // (1)
namespace views {
inline constexpr /*unspecified*/ take = /*unspecified*/; // (2)
}
}
概要
take
で得られるview
の大きさは、指定した個数に関わらず、元のRangeの大きさを超えることは無い。
Rangeコンセプト
borrowed | sized | output | input | forward | bidirectional | random_access | contiguous | common | viewable | view |
---|---|---|---|---|---|---|---|---|---|---|
(1) | (1) | (1) | (1) | (1) | (1) | (1) | (1) | (1) | ○ | ○ |
- (1):
V
に従う
テンプレートパラメータ制約
view<V>
効果
- (2):
E
およびF
を式、型T
をremove_cvref_t<decltype((E))>
、型D
をrange_difference_t<decltype((E))>
とする。式views::take(E, F)
の効果は以下の通りdecltype((F))
がconvertible_to<D>
のモデルでなければ、呼び出しは不適格T
がranges::empty_view
の特殊化であれば、((void) F,decay-copy(E))
と等しい。ただし、E
とF
の評価順序は不定順で序列化(indeterminately sequenced)されるT
がrandom_access_range
およびsized_range
のモデルであり、かつ次のいずれかの特殊化であるとき、T(ranges::begin(E),ranges::begin(E) +min<D>(ranges::size(E), F))
と等しい。ただし、E
は1度だけ評価されるspan
(ただし、T::extent ==dynamic_extent
であること)basic_string_view
ranges::iota_view
ranges::subrange
- それ以外のとき、
ranges::take_view(E, F)
take_view
でラップする必要が無い型ではtake_view
を使わないようになっている。
メンバ関数
名前 | 説明 | 対応バージョン |
---|---|---|
(constructor) |
コンストラクタ | C++20 |
base |
V の参照を取得する |
C++20 |
begin |
先頭を指すイテレータを取得する | C++20 |
end |
番兵を取得する | C++20 |
size |
要素数を取得する | C++20 |
r
を元のRangeとする。size
はranges::size(r)
が有効な式であるときに定義される。
継承しているメンバ関数
名前 | 説明 | 対応バージョン |
---|---|---|
empty |
Rangeが空かどうかを判定する | C++20 |
operator bool |
Rangeが空でないかどうかを判定する | C++20 |
data |
Rangeの先頭へのポインタを取得する | C++20 |
front |
先頭要素への参照を取得する | C++20 |
back |
末尾要素への参照を取得する | C++20 |
operator[] |
要素へアクセスする | C++20 |
推論補助
名前 | 説明 | 対応バージョン |
---|---|---|
(deduction_guide) |
クラステンプレートの推論補助 | C++20 |
例
#include <ranges>
#include <iostream>
int main() {
using namespace std;
for (int i : views::iota(1) | views::take(5)) {
cout << i;
}
}
出力
12345
バージョン
言語
- C++20
処理系
- Clang: 13.0.0
- GCC: 10.1.0
- ICC: ?
- Visual C++: 2019 Update 10
参照
- N4861 24 Ranges library
- C++20 ranges
- P2367R0 Remove misuses of list-initialization from Clause 24 (本提案文書はC++20に遡って適用されている)