take_view class （C++標準連結庫）
另一個檢視中第一 個 N 個元素的檢視。
語法
template<view V>
class take_view : public view_interface<take_view<V>>;
範本參數
V
基礎範圍的型別。
檢視特性
如需下列專案的描述，請參閱 檢視類別特性
| 特性 | 描述 |
|---|---|
| 範圍配接器 | views::take |
| 基礎範圍 | 任何範圍 |
| 項目類型 | 與基礎範圍相同 |
| 檢視反覆運算器類別 | 與基礎範圍相同 |
| 大小 | No |
為 const-iterable |
只有當基礎範圍是 const 可反覆運算時 |
| 通用範圍 | 只有在基礎範圍滿足 random_access_range 和時才 sized_range |
| 借用範圍 | 只有當基礎範圍是 borrowed_range |
成員
| 成員函式 | 說明 |
|---|---|
| 建構函式 | 建構檢視。 |
baseC++20 |
取得基礎範圍。 |
beginC++20 |
取得第一個專案的反覆運算器。 |
endC++20 |
取得檢視結尾的 sentinel。 |
sizeC++20 |
取得項目數目。 基礎範圍必須滿足 sized_range。 |
繼承自 view_interface |
說明 |
backC++20 |
取得最後一個專案。 |
dataC++20 |
取得第一個專案的指標。 |
emptyC++20 |
測試檢視是否為空白。 |
frontC++20 |
取得第一個專案。 |
operator[]C++20 |
取得位於指定位置的專案。 |
operator boolC++20 |
測試檢視是否不是空的。 |
需求
標頭： <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 大於基礎檢視中的元素數目，則檢視會包含基礎範圍中的所有專案。
如需範本參數類型的相關信息，請參閱 範本參數。
傳回值
， 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 必須有相同的反覆運算器和 sentinel 類型。
end
取得檢視結尾的 sentinel。
1) constexpr auto end() requires !(Simple_view<V>);
2) constexpr auto end() const requires range<const V>;
參數
無。
傳回值
檢視中最後一個專案後面的 sentinel。
備註
對於 1，需求 Simple_view<V> 表示檢視 V 和 const V 必須有相同的反覆運算器和 sentinel 類型。
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)。