namespace std::ranges {
template<view V>
class drop_view : public view_interface<drop_view<V>> { …… }; // (1)
namespace views {
inline constexpr /*unspecified*/ drop = /*unspecified*/; // (2)
}
}
概要
- (1): 元のRangeの先頭から指定した個数の値を除去したRangeとして振る舞う
view - (2):
drop_view、または(1)の動作を実現するviewを生成するRangeアダプタオブジェクト
元のRangeの大きさを超える個数が指定された場合、dropが返すviewは空になる。
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::drop(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) + min<D>(ranges::size(E), F), ranges::end(E))と等しい。ただし、Eは1度だけ評価されるspan(ただし、T::extent == dynamic_extentであること)basic_string_viewranges::iota_viewranges::subrange
- それ以外のとき、
ranges::drop_view(E, F)
drop_viewでラップする必要が無い型ではdrop_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 |
cbegin |
定数イテレータを取得する | C++23 |
cend |
定数イテレータ(番兵)を取得する | C++23 |
推論補助
| 名前 | 説明 | 対応バージョン |
|---|---|---|
(deduction_guide) |
クラステンプレートの推論補助 | C++20 |
例
#include <ranges>
#include <iostream>
int main() {
using namespace std;
for (int i : views::iota(1, 10) | views::drop(5)) {
cout << i;
}
}
出力
6789
バージョン
言語
- C++20
処理系
- Clang: 13.0.0 ✅
- GCC: 10.1.0 ✅
- ICC: ?
- Visual C++: 2019 Update 10 ✅