take_view クラス (C++ 標準ライブラリ)
別のビューの最初の N 要素のビュー。
構文
template<view V>
class take_view : public view_interface<take_view<V>>;
テンプレート パラメーター
V
基になる範囲の型。
特性の表示
以下の項目の説明については、 View クラスの特性を参照してください。
| 特徴 | 説明 |
|---|---|
| 範囲アダプター | views::take |
| 基になる範囲 | 任意の範囲 |
| 要素の種類 | 基になる範囲と同じ |
| 反復子カテゴリの表示 | 基になる範囲と同じ |
| サイズ | いいえ |
const対応 |
基になる範囲が const 可能な場合のみ |
| 共通範囲 | 基になる範囲が random_access_range を満たしている場合にのみ、 sized_range |
| 借用範囲 | 基になる範囲が borrowed_range |
メンバー
| メンバー関数 | 説明 |
|---|---|
| コンストラクター | ビューを構築します。 |
baseC++20 |
基になる範囲を取得します。 |
beginC++20 |
最初の要素を指す反復子を取得します。 |
endC++20 |
ビューの最後にあるセンチネルを取得します。 |
sizeC++20 |
要素の数を取得します。 基になる範囲は、 sized_rangeを満たす必要があります。 |
継承の対象 view_interface |
説明 |
backC++20 |
最後の要素を取得します。 |
dataC++20 |
最初の要素へのポインターを取得します。 |
emptyC++20 |
ビューが空かどうかをテストします。 |
frontC++20 |
最初の要素を取得します。 |
operator[]C++20 |
指定した位置にある要素を取得します。 |
operator boolC++20 |
ビューが空でないかどうかをテストします。 |
要件
Header: <ranges> (C++20 以降)
名前空間: std::ranges
コンパイラ オプション: /std:c++20 以降が必要です。
コンストラクター
のインスタンスを構築する take_view
1) take_view() requires default_initializable<V> = default;
2) constexpr take_view(V base, range_difference_t<V> count);
パラメーター
base
基になるビュー。
count
基になるビューの前面から取得する要素の数。 countが基になるビュー内の要素の数を超える場合、ビューには基になる範囲内のすべての要素が含まれます。
テンプレート パラメーターの型の詳細については、「 Template パラメーターを参照してください。
戻り値
take_view。これは、別のビューからの最初のN要素のビューです。 ドロップする要素の数が基になる範囲よりも多い場合は、 empty_view が返されます。
解説
take_viewを作成する最善の方法は、views::take範囲アダプターを使用することです。 範囲アダプターは、ビュー クラスを作成するための目的の方法です。 ビューの種類は、独自のカスタム ビューの種類を作成する場合にのみ公開されます。
1) 要素のない take_view を作成します。 基になるビューは既定で構築されています。 base() は、 V()のコピーを返します。
2) baseとカウントからtake_viewを作成します。 base は std::move()を介して移動されます。
countが基になる範囲内の要素の数より少ない場合は、countによってtake_viewのサイズが決まります。
countが基になる範囲内の要素の数より大きい場合、take_viewには基になる範囲内のすべての要素が含まれます。
例: take_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
int main()
{
std::vector<int> v{0, 1, 2, 3, 4, 5, 6};
auto newView = std::views::take(v, 3);
for (auto& e : newView)
{
std::cout << e << ' '; // 0 1 2
}
std::cout << '\n';
// Use the '|' operator to create a take_view
for (auto i : v | std::views::take(3))
{
std::cout << i << ' '; // 0 1 2
}
}
0 1 2
0 1 2
base
基になるビューのコピーを取得します。
// Uses a copy constructor to return the underlying view
1) constexpr V base() const & requires std::copy_constructible<V>;
// Uses a move constructor to return the underlying view
2) constexpr V base() &&;
パラメーター
ありません。
戻り値
基になるビュー。
begin
ビューの最初の要素を指す反復子を取得します。
constexpr auto begin() requires (!Simple_view<V>);
constexpr auto begin() const requires range<const V>;
パラメーター
ありません。
戻り値
ビューの最初の要素を指す反復子。
解説
1 の場合、 Simple_view<V> 要件は、ビュー V と const V が同じ反復子とセンチネル型を持つ必要があることを意味します。
end
ビューの最後にあるセンチネルを取得します。
1) constexpr auto end() requires !(Simple_view<V>);
2) constexpr auto end() const requires range<const V>;
パラメーター
ありません。
戻り値
ビューの最後の要素に続くセンチネル。
解説
1 の場合、 Simple_view<V> 要件は、ビュー V と const V が同じ反復子とセンチネル型を持つ必要があることを意味します。
size
要素の数を取得します。
constexpr auto size() requires sized_range<V>;
constexpr auto size() const requires sized_range<const V>;
パラメーター
ありません。
戻り値
take_view にある要素の数。
take_viewが明示的なcountで構築された場合:
countが基になる範囲内の要素の数より少ない場合は、ビューのサイズとして返されます。countが基になる範囲内の要素の数より大きい場合、ビューのサイズはranges::size(base)。