Skip to content

Latest commit

 

History

History
125 lines (93 loc) · 5.8 KB

split_view.md

File metadata and controls

125 lines (93 loc) · 5.8 KB

split_view

  • ranges[meta header]
  • std::ranges[meta namespace]
  • class template[meta id-type]
  • cpp20[meta cpp]
namespace std::ranges {

  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>> { …… };   // (1)

  namespace views {
    inline constexpr /*unspecified*/ split = /*unspecified*/;                // (2)
  }
}
  • forward_range[link forward_range.md]
  • view[link view.md]
  • iterator_t[link iterator_t.md]
  • indirectly_comparable[link /reference/iterator/indirectly_comparable.md]
  • ranges::equal_to[link /reference/functional/equal_to.md]

概要

指定した区切り文字（デリミタ）によって、入力文字範囲の分割を行うRangeアダプタ。

  • (1): 入力の文字範囲を、その要素型の文字または文字列からなるパターンをデリミタとして分割し、切り出した文字列（部分Range）を要素とする新たなRangeに変換するview
  • (2): split_viewを生成するRangeアダプタオブジェクト

入力範囲VもデリミタPatternも共にforward_range（かつview）であることしか求められていないため、実際には文字列の分割に限らず、任意のforward_rangeをforward_rangeによって表現されるパターンによって分割することができる。

Rangeコンセプト（split_viewそのもの）

borrowed sized output input forward bidirectional random_access contiguous common viewable view
○ ○ (1) ○ ○

Rangeコンセプト (split_viewの要素である、切り出した部分文字列を示す各部分Range)

borrowed sized output input forward bidirectional random_access contiguous common viewable view
○ ※ ※ ○ ○ ※ ※ ※ ※ ○ ○
  • ※: Vに従う

テンプレートパラメータ制約

  • V、Patternがviewかつforward_range
  • VのイテレータとPatternのイテレータが等値比較可能である

効果

  • (2): 式views::split(E, F)の効果はsplit_view(E, F)と等しい。

メンバ関数

名前 説明 対応バージョン
(constructor) コンストラクタ C++20
base Vの参照を取得する C++20
begin 先頭を指すイテレータを取得する C++20
end 番兵を取得する C++20

継承しているメンバ関数

名前 説明 対応バージョン
empty Rangeが空かどうかを判定する C++20
operator bool Rangeが空でないかどうかを判定する C++20
front 先頭要素への参照を取得する C++20
cbegin 定数イテレータを取得する C++23
cend 定数イテレータ（番兵）を取得する C++23

推論補助

名前 説明 対応バージョン
(deduction_guide) クラステンプレートの推論補助 C++20

例

#include <ranges>
#include <string_view>
#include <iostream>

int main() {
  using namespace std;
  using namespace std::literals;

  for (auto sv : "hello, world"sv | views::split(", "sv)) {
    std::cout << string_view{sv.begin(), sv.end()} << '\n';
  }
}
  • views::split[color ff0000]

パターンとしてC文字列を使うとき、ヌル文字を特別扱いしないため注意。

出力

hello
world

バージョン

言語

  • C++20

処理系

  • Clang: 13.0.0 [mark verified]
  • GCC: 10.1.0 [mark verified]
  • ICC: ?
  • Visual C++: 2019 Update 10 [mark verified]

参照