std::ranges::stride_view(C++23)

namespace std::ranges {
  template<input_range V>
    requires view<V>
  class stride_view : public view_interface<stride_view<V>> {…… }; // (1)

  namespace views {
    inline constexpr /*unspecified*/ stride = /*unspecified*/;      // (2)
  }
}

概要

stride_viewはRangeの要素を指定個数飛ばしに見るview。

(1): stride_viewのクラス定義
(2): stride_viewを生成するカスタマイゼーションポイントオブジェクト(Rangeアダプタオブジェクトではない)

Rangeコンセプト

borrowed	sized	output	input	forward	bidirectional	random_access	contiguous	common	viewable	view
	※	※	※	※	※	※		※	○	○

※: 元となるRangeに従う

効果

(2): 式views::stride(E, N)の効果はstride_view(E, N)と等しい

メンバ関数

名前	説明	対応バージョン
`(constructor)`	コンストラクタ	C++23
`base`	`V`の参照を取得する	C++23
`stride`	1回で移動する要素数を取得する	C++23
`begin`	先頭を指すイテレータを取得する	C++23
`end`	番兵を取得する	C++23
`size`	要素数を取得する	C++23

継承しているメンバ関数

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

推論補助

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

例

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

int main() {
  std::vector v = {0, 1, 2, 3, 4, 5, 6};

  std::println("{}", v | std::views::stride(3));

  for (auto& i : v | std::views::stride(3)) {
    i *= 10; // 要素を書き換えても良い
  }
  std::println("{}", v);
}

出力

[0, 3, 6]
[0, 1, 2, 30, 4, 5, 60]

バージョン

言語

C++23

処理系

Clang: 16.0 ✅
GCC: 13.2 ✅
Visual C++: 2022 Update 4 ✅

参照

N4950 26 Ranges library