std::ranges::generate(C++20)

namespace std::ranges {
  template <input_or_output_iterator O,
            sentinel_for<O> S,
            copy_constructible F>
    requires invocable<F&> && indirectly_writable<O, invoke_result_t<F&>>
  constexpr O
    generate(O first,
             S last,
             F gen);                  // (1) C++20

  template <class R,
            copy_constructible F>
    requires invocable<F&> && output_range<R, invoke_result_t<F&>>
  constexpr borrowed_iterator_t<R>
    generate(R&& r,
             F gen);                  // (2) C++20

  template <execution-policy Ep,
            random_access_iterator O,
            sized_sentinel_for<O> S,
            copy_constructible F>
    requires invocable<F&> && indirectly_writable<O, invoke_result_t<F&>>
  O generate(Ep&& exec,
             O first,
             S last,
             F gen);                  // (3) C++26

  template <execution-policy Ep,
            sized-random-access-range R,
            copy_constructible F>
    requires invocable<F&> && indirectly_writable<iterator_t<R>, invoke_result_t<F&>>
  borrowed_iterator_t<R>
    generate(Ep&& exec,
             R&& r,
             F gen);                  // (4) C++26
}

概要

出力の範囲へ関数の結果を書き込む。

(1): イテレータ範囲を指定する
(2): Rangeを直接指定する
(3): (1)の並列アルゴリズム版。実行ポリシーを指定する
(4): (2)の並列アルゴリズム版。実行ポリシーを指定する

効果

[first,last) のそれぞれのイテレータについて関数オブジェクト gen を呼び出し、その戻り値を代入する。

戻り値

last

計算量

正確に last - first 回の gen の呼び出しと代入が行われる。

例

基本的な使い方

#include <algorithm>
#include <iostream>
#include <vector>

int main() {
  std::vector<int> v(10);

  // 2 の累乗の値を生成する
  int n = 1;
  std::ranges::generate(v, [&n]() { auto t = n; n *= 2; return t; });

  for (int x : v ) {
    std::cout << x << ",";
  }
}

出力

1,2,4,8,16,32,64,128,256,512,

並列アルゴリズムの例 (C++26)

#include <algorithm>
#include <iostream>
#include <vector>
#include <execution>

int main() {
  std::vector<int> v(10);

  // 並列に全要素を99で埋める
  std::ranges::generate(std::execution::par, v, [] { return 99; });

  for (int x : v) {
    std::cout << x << ' ';
  }
  std::cout << std::endl;
}

出力

99 99 99 99 99 99 99 99 99 99

std::ranges::generate(C++20)

概要

効果

戻り値

計算量

例

基本的な使い方

出力

並列アルゴリズムの例 (C++26)

出力

バージョン

言語

処理系

参照