split_view class （C++標準連結庫）
根據分隔符將檢視分割成子範圍。 分隔符可以是單一專案或項目的檢視。 分隔符不是所產生 split_view之的一部分。
相關的檢視是類別 lazy_split_view 。 和 lazy_split_view 之間的split_view主要差異如下：
| 檢視 | 可以分割 const 範圍 |
範圍類型 |
|---|---|---|
split_view |
否 | 支援 forward_range 或更新版本。 |
lazy_split_view |
是 | 支援 input_range 或更新版本。 |
偏好 split_view ，因為它更有效率，除非您必須分割為 const的範圍。
語法
template<forward_range V, forward_range Pattern>
requires view<V> && view<Pattern> &&
indirectly_comparable<iterator_t<V>, iterator_t<Pattern>, ranges::equal_to>
class split_view : public view_interface<split_view<V, Pattern>>;
範本參數
Pattern
指定分隔符序列之檢視的類型。
V
基礎檢視的類型。
檢視特性
如需下列專案的描述，請參閱 檢視類別特性
| 特性 | 描述 |
|---|---|
| 範圍配接器 | views::split |
| 基礎範圍 | 與基礎範圍相同 |
| 項目類型 | range_reference_t<V> |
| 檢視反覆運算器類別 | 滿足 forward_range |
| 大小 | No |
為 const-iterable |
No |
| 通用範圍 | 只有在基礎範圍滿足時才 common_range |
| 借用範圍 | No |
成員
| 成員函式 | 說明 |
|---|---|
| 建構函式 | 建構檢視。 |
baseC++20 |
取得基礎範圍。 |
beginC++20 |
取得第一個專案的反覆運算器。 |
endC++20 |
取得檢視結尾的 sentinel。 |
繼承自 view_interface |
說明 |
emptyC++20 |
測試檢視是否為空白。 |
frontC++20 |
取得第一個專案。 |
operator boolC++20 |
測試檢視是否不是空的。 |
需求
標頭： <ranges> （自C++20起）
命名空間：std::ranges
需要編譯程式選項：/std:c++20或更新版本。
建構函式
建構的實例 split_view
1) split_view() requires default_initializable<V> && default_initializable<Pattern> = default;
2) constexpr split_view(V base, Pattern pattern);
3) template<input_range R> requires constructible_from<V, views::all_t<R>> &&
constructible_from<Pattern, single_view<range_value_t<R>>>
constexpr split_view(R&& rg, range_value_t<R> e);
參數
e
單一專案，可識別要分割檢視的位置。 專案不是產生的檢視的一部分。
base
基礎檢視。
pattern
項目檢視，可識別要分割檢視的位置。 項目的檢視不屬於結果檢視的一部分。
rg
要分割的範圍。
如需範本參數類型的相關信息，請參閱 範本參數。
傳回值
split_view包含一或多個子範圍的實例。
備註
建立 split_view 的最佳方式是使用 views::split 範圍配接器。 範圍配接器是建立檢視類別的預定方式。 只有在您想要建立自己的自定義檢視類型時，才會公開檢視類型。
1） 建立 split_view 預設建構的 。 基礎檢視和 pattern 是預設建構的。 base() 會傳回的 V()複本。
2） 使用分隔符序列分割檢視來建立 split_view 。
3） 使用單一分隔符分割檢視來建立 split_view 。
例 split_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
int main()
{
std::vector<int> rg{ 1, 2, 3, 1, 2, 3, 4, 5, 6 };
// pipe syntax using range adaptor
for (const auto& subrange : rg | std::views::split(3))
{
// outputs
// 1 2
// 1 2
// 4 5 6
for (const auto& elem : subrange)
{
std::cout << elem << ' ';
}
std::cout << '\n';
}
int delimiters[] = {2, 3};
for (auto splitRange : std::views::split(rg, delimiters)) // ctor syntax
{
for (auto& i : splitRange)
{
std::cout << i << " "; // 1 1 4 5 6
}
}
}
1 2
1 2
4 5 6
1 1 4 5 6
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();
參數
無。
傳回值
指向檢視中第一個專案的反覆運算器。
end
取得檢視結尾的 sentinel。
constexpr auto end();
參數
無。
傳回值
檢視中最後一個專案後面的 sentinel：