take_while_view クラス (C++ 標準ライブラリ)
述語に一致する範囲の先頭要素を含むビュー。
構文
template<view V, class Pred> requires
input_range<V> && is_object_v<Pred> &&
indirect_unary_predicate<const Pred, iterator_t<V>>
class take_while_view : public view_interface<take_while_view<V, Pred>>;
テンプレート パラメーター
Pred
ビューに配置する先頭要素を決定する述語の型。
V
基になるビューの型。
特性の表示
以下の項目の説明については、 View クラスの特性を参照してください。
| 特徴 | 説明 |
|---|---|
| 範囲アダプター | views::take_while |
| 基になる範囲 | input_range以上を満たす必要があります |
| 要素の種類 | 基になる範囲と同じ |
| 反復子カテゴリの表示 | 基になる範囲と同じ |
| サイズ | いいえ |
const対応 |
基になる範囲が const iterable であり、述語が const 参照を操作できる場合にのみ。 |
| 共通範囲 | いいえ |
| 借用範囲 | いいえ |
メンバー
| メンバー関数 | 説明 |
|---|---|
| コンストラクターC++20 | ビューを構築します。 |
baseC++20 |
基になる範囲を取得します。 |
beginC++20 |
最初の要素を指す反復子を取得します。 |
endC++20 |
ビューの最後にあるセンチネルを取得します。 |
predC++20 |
取得する要素を決定する述語への参照を取得します。 |
継承の対象 view_interface |
説明 |
backC++20 |
最後の要素を取得します。 |
dataC++20 |
最初の要素へのポインターを取得します。 |
emptyC++20 |
ビューが空かどうかをテストします。 |
frontC++20 |
最初の要素を取得します。 |
operator[]C++20 |
指定した位置にある要素を取得します。 |
operator boolC++20 |
ビューが空でないかどうかをテストします。 |
size |
ビュー内の要素の数を取得します。 |
要件
Header: <ranges> (C++20 以降)
名前空間: std::ranges
コンパイラ オプション: /std:c++20 以降が必要です。
コンストラクター
のインスタンスを構築する take_while_view
1) take_while_view() requires
default_initializable<V> &&
default_initializable<Pred> = default;
2) constexpr take_while_view(V base, Pred pred);
パラメーター
base
基になるビュー。
pred
ビューに配置する先頭要素を決定する述語。
テンプレート パラメーターの型の詳細については、「 Template パラメーターを参照してください。
戻り値
take_while_view オブジェクト。
解説
take_while_viewを作成する最善の方法は、views::take_while範囲アダプターを使用することです。 範囲アダプターは、ビュー クラスを作成するための目的の方法です。 独自のカスタム ビューの種類を作成する場合は、ビューの種類が公開されます。
1) move は、base ビューとpred述語からtake_while_viewを構築します。 baseとpredの両方がstd::move()経由で移動されます。
2) 空の take_while_viewを構築します。 基になるビューと述語は、既定で構築されます。
例: take_while_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 twv = std::views::take_while(v, [](int i) {return i >= 0; });
for (auto& e : twv)
{
std::cout << e << ' '; // 0 1 2 3
}
std::cout << '\n';
// Using the '|' operator to create a take_view
for (auto i : v | std::views::take_while([](int i) {return i < 5; }))
{
std::cout << i << ' '; // 0 1 2 3 -4
}
}
0 1 2 3
0 1 2 3 -4
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
ビューの最初の要素を指す反復子を取得します。
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires
range<const V> &&
indirect_unary_predicate<const Pred, iterator_t<const V>>
パラメーター
ありません。
戻り値
ビューの最初の要素を指す反復子。 ビューに述語がない場合、動作は未定義です。
解説
1 の場合、 Simple_view 要件は、ビュー V と const V が同じ反復子とセンチネルの型を持っていることを意味します。
end
ビューの最後にあるセンチネルを取得します。
1) constexpr auto end() requires (!Simple_view<V>);
2) constexpr auto end() const requires
range<const V> &&
indirect_unary_predicate<const Pred, iterator_t<const V>
パラメーター
ありません。
戻り値
ビューの最後の要素に続くセンチネル。
解説
1 の場合、 Simple_view 要件は、ビュー V と const V が同じ反復子とセンチネルの型を持っていることを意味します。
pred
ビュー内のどの先頭要素を選択するために使用される述語への参照を取得します。
constexpr const Pred& pred() const;
戻り値
ビューに配置する先頭の要素を選択するために使用される述語への参照。
例 pred
// 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 mv = v | std::views::take_while(
[](int i) {return i < 5; });
std::cout << std::boolalpha << mv.pred()(v[6]); // outputs false because v[6] = 6 and 6 is not less than 5 (the predicate)
}