begin.md

begin

• ranges[meta header]
• std::ranges[meta namespace]
• take_view[meta class]
• function[meta id-type]
• cpp20[meta cpp]

constexpr auto begin()
  requires (!simple-view<V>);       // (1) C++20

constexpr auto begin() const
  requires range<const V>;          // (2) C++20

概要

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

戻り値

base_を元のviewを表すメンバ変数、count_を取得する要素数を表すメンバ変数とする。

入力がsized_rangeかつrandom_access_rangeの場合：

• (1), (2) : 以下と等価：

  return ranges::begin(base_);

入力がsized_rangeだがrandom_access_rangeではない場合：

• (1), (2) : 以下と等価：

  auto sz = range_difference_t<V>(size());
  return counted_iterator(ranges::begin(base_), sz);

  • range_difference_t[link /reference/ranges/range_difference_t.md]
  • counted_iterator[link /reference/iterator/counted_iterator.md]

それ以外の場合：

• (1), (2) : 以下と等価：

  return counted_iterator(ranges::begin(base_), count_);

  • counted_iterator[link /reference/iterator/counted_iterator.md]

例

#include <ranges>
#include <vector>
#include <iostream>

int main() {
  std::vector<int> vec = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};

  std::ranges::take_view r{vec, 5};

  auto it = r.begin();

  int x = *it;
  std::cout << x << '\n';
}

• begin[color ff0000]

出力

1

バージョン

言語

• C++20

処理系

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

参照

• P2393R1 Cleaning up integer-class types