begin.md

begin

• ranges[meta header]
• std::ranges[meta namespace]
• chunk_view[meta class]
• function[meta id-type]
• cpp23[meta cpp]

constexpr outer-iterator begin();       // (1) C++23

constexpr outer-iterator begin() const
  requires forward_range<const V>;      // (2) C++23

• outer-iterator[italic]

概要

先頭要素を指すイテレータを取得する。

効果

• (1) : 以下と等価

  V& r = base_;
  auto first = ranges::begin(r);
  if constexpr (forward_range<V>) {
    return outer-iterator<false>(this, std::move(first));
  } else {
    current_ = first;
    remainder_ = n_;
    return outer-iterator<false>(this);
  }

• (2) : 以下と等価

  return outer-iterator<true>(this, ranges::begin(base_));

ここで、outer-iteratorは説明専用のイテレータクラスであり、current_とremainder_はchunk_viewの説明専用のメンバ変数である。

例

#include <ranges>
#include <vector>
#include <print>

int main() {
  std::vector<int> v = {1, 2, 3, 4, 5, 6, 7, 8};
  
  std::ranges::chunk_view cv{v, 3};
  
  auto it = cv.begin();
  
  // 最初のチャンクを出力
  std::println("{}", *it);
}

• begin[color ff0000]

出力

[1, 2, 3]

バージョン

言語

• C++23

処理系

• Clang: 17 [mark verified]
• GCC: 14.0 [mark verified]
• Visual C++: 2022 Update 3 [mark verified]

参照

• N4950 26.7.29 Chunk view