filter_view class （C++標準連結庫）
篩選出不符合述詞之範圍元素的檢視。
語法
template<ranges::input_range V, indirect_unary_predicate<iterator_t<V>> Pred>
requires view<V> && is_object_v<Pred>
class filter_view : public view_interface<filter_view<V, Pred>>;
範本參數
V
基礎範圍的型別。
Pred
判斷要保留哪些元素的述詞型別。
檢視特性
如需下列專案的描述，請參閱 檢視類別特性
| 特性 | 描述 |
|---|---|
| 範圍配接器 | views::filter |
| 基礎範圍 | 必須滿足 input_range 或更新版本 |
| 項目類型 | 與基礎範圍相同 |
| 檢視反覆運算器類別 | input_range、 forward_range、 或 bidirectional_range 視基礎範圍而定 |
| 大小 | No |
為 const-iterable |
No |
| 通用範圍 | 只有在基礎範圍滿足時才 common_range |
| 借用範圍 | 只有在基礎範圍滿足時才 borrowed_range |
成員
| 成員函式 | 說明 |
|---|---|
| 建構函式C++20 | 建構檢視。 |
baseC++20 |
取得基礎範圍。 |
beginC++20 |
取得第一個專案的反覆運算器。 |
endC++20 |
取得檢視結尾的 sentinel。 |
predC++20 |
取得述詞的參考，以決定要卸除的專案。 |
| 繼承自 view_interface | 說明 |
backC++20 |
取得最後一個專案。 |
emptyC++20 |
測試檢視是否為空白。 |
frontC++20 |
取得第一個專案。 |
operator boolC++20 |
測試檢視是否不是空的。 |
需求
標頭： <ranges> （自C++20起）
命名空間：std::ranges
需要編譯程式選項：/std:c++20或更新版本。
建構函式
建構的實例 filter_view
1) constexpr filter_view(V base, P pred);
2) filter_view() requires default_initializable<V> && default_initializable<Pred> = default;
參數
base
基礎檢視。
pred
判斷要從基礎檢視保留哪些元素的述詞。
如需範本參數類型的相關信息，請參閱 範本參數。
傳回值
filter_view 執行個體。
備註
建立 filter_view 的最佳方式是使用 views::filter 範圍配接器。 範圍配接器是建立檢視類別的預定方式。 如果您想要建立自己的自定義檢視類型，則會公開檢視類型。
1） 建立值初始化 filter_view的 。 述詞和基礎檢視必須是可預設初始化的。
2） 移動會 filter_view 從 base 檢視和 pred 述詞建構 。 和 pred 都會base透過std::move()移動。
範例: filter_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
void print(auto v)
{
for (auto& x : v)
{
std::cout << x << ' ';
}
std::cout << '\n';
}
int main()
{
std::vector<int> v{0, 1, -2, 3, -4, -5, 6};
auto myView = std::views::filter(v, [](int i) {return i > 0; });
print(myView); // outputs 1 3 6
auto myView2 = v | std::views::filter([](int i) {return i < 3; });
print(myView2); // outputs 0 1 -2 -4 -5
}
1 3 6
0 1 -2 -4 -5
base
取得基礎範圍。
// Uses a copy constructor to return the underlying range
constexpr V base() const& requires std::copy_constructible<V>;
// Uses std::move() to return the underlying range
constexpr V base() &&;
參數
無。
傳回
基礎檢視。
begin
取得檢視中第一個專案的反覆運算器。
constexpr auto begin();
傳回值
指向檢視中第一個專案的反覆運算器。 如果檢視沒有述詞，則行為是未定義的。
end
取得檢視結尾的 sentinel。
constexpr auto end()
傳回值
檢視中最後一個專案後面的 sentinel：
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::filter(
[](int i) {return i < 5; }); // keep the elements < 5
std::cout << std::boolalpha << mv.pred()(v[6]); // outputs "false" because v[6] = 6 and 6 is not less than 5 (the predicate)
}