join_view
class (C++標準連結庫)
將範圍範圍的元素結合成單一檢視。
語法
template<input_range R> requires view<R> && input_range<range_reference_t<R>> &&
(is_reference_v<range_reference_t<R>> || view<range_value_t<R>>)
class join_view : public view_interface<join_view<R>>;
範本參數
R
基礎範圍的型別。 必須滿足 input_range
或更新版本。
檢視特性
如需下列專案的描述,請參閱 檢視類別特性
特性 | 描述 |
---|---|
範圍配接器 | views::join |
基礎範圍 | 必須滿足 input_range 或更新版本 |
項目類型 | 與基礎範圍相同 |
檢視反覆運算器類別 | input_range bidirectional_range 取決於所要查看的基礎範圍 |
大小 | No |
為 const -iterable |
只有當基礎範圍是 const 可反覆運算時 |
通用範圍 | 只有在基礎範圍滿足時才 common_range |
借用範圍 | No |
成員
成員函式 | 說明 |
---|---|
建構函式C++20 | join_view 建構 。 |
base C++20 |
取得基礎範圍的參考。 |
begin C++20 |
取得第一個專案的反覆運算器。 |
end C++20 |
取得檢視結尾的 sentinel。 |
繼承自 view_interface |
說明 |
back C++20 |
取得最後一個專案。 |
empty C++20 |
測試檢視是否為空白。 |
front C++20 |
取得第一個專案。 |
operator bool C++20 |
測試檢視是否不是空的。 |
備註
建立 join_view
的最佳方式是使用 views::join
範圍配接器。 範圍配接器是存取檢視類別的預定方式。 如果您想要建立自己的自定義檢視類型,則會公開檢視類型。
當您想要將多個範圍合併成單一檢視時,此檢視很有用。
需求
標頭: <ranges>
(自C++20起)
命名空間:std::ranges
需要編譯程式選項:/std:c++20
或更新版本。
建構函式
建立 join_view
的執行個體。
1) join_view() = default;
2) constexpr explicit join_view(R base)
參數
base
基礎範圍。
如需範本參數類型的相關信息,請參閱 範本參數。
備註
1) 預設建構 。join_view
2) 從 base
建構 join_view
。
範例: join_view
// requires /std:c++20, or later
#include <iostream>
#include <vector>
#include <ranges>
int main()
{
std::vector<int> rg1{1, 2, 3, 4};
std::vector<int> rg2{5, 6, 7};
std::vector<int> rg3{8, 9, 10, 11, 12, 13};
std::vector<int> rangeOfRanges[] {rg1, rg2, rg3};
auto jv = std::ranges::join_view(rangeOfRanges);
for (auto& e : jv)
{
std::cout << e << " ";
}
}
1 2 3 4 5 6 7 8 9 10 11 12 13
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();
constexpr auto begin() const
requires ranges::input_range<const V> && std::is_reference_v<ranges::range_reference_t<const V>>;
參數
無。
傳回值
指向檢視中第一個專案的反覆運算器:
end
取得檢視結尾的 sentinel。
constexpr sentinel_t<R> end();
constexpr auto end() const requires range<const R>
參數
無。
傳回值
檢視中最後一個專案後面的 sentinel: