共用方式為


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_rangebidirectional_range取決於所要查看的基礎範圍
大小 No
const-iterable 只有當基礎範圍是 const 可反覆運算時
通用範圍 只有在基礎範圍滿足時才 common_range
借用範圍 No

成員

成員函式 說明
建構函式C++20 join_view建構 。
baseC++20 取得基礎範圍的參考。
beginC++20 取得第一個專案的反覆運算器。
endC++20 取得檢視結尾的 sentinel。
繼承自 view_interface 說明
backC++20 取得最後一個專案。
emptyC++20 測試檢視是否為空白。
frontC++20 取得第一個專案。
operator boolC++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() &&;

參數

無。

傳回值

  1. 傳回的檢視是複製建構的。
  2. 傳回的檢視會建構移動。

begin

取得檢視中第一個專案的反覆運算器。

constexpr auto begin();
constexpr auto begin() const
    requires ranges::input_range<const V> && std::is_reference_v<ranges::range_reference_t<const V>>;

參數

無。

傳回值

指向檢視中第一個專案的反覆運算器:

具有元素 10、20 和 30 的向量圖片。第一個元素包含 10,且標示為 begin()。最後一個專案包含 30 個,且標示為「最後一個專案」。最後一個專案後面的虛方塊表示 sentinel 且標示為 end()。

end

取得檢視結尾的 sentinel。

constexpr sentinel_t<R> end();
constexpr auto end() const requires range<const R>

參數

無。

傳回值

檢視中最後一個專案後面的 sentinel:

具有元素 10、20 和 30 的向量圖片。第一個元素包含 10,且標示為 begin()。最後一個專案包含 30 個,且標示為「最後一個專案」。最後一個專案後面的虛方塊表示 sentinel 且標示為 end()。

另請參閱

join 範圍配接器
<ranges>
檢視類別