Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      std::generate

      From cppreference.com
      <cpp‎ |algorithm
       
       
      Algorithm library
      Constrained algorithms and algorithms on ranges(C++20)
      Constrained algorithms, e.g.ranges::copy,ranges::sort, ...
      Execution policies(C++17)
      Sorting and related operations
      Partitioning operations
      Sorting operations
      Binary search operations
      (on partitioned ranges)
      Set operations (on sorted ranges)
      Merge operations (on sorted ranges)
      Heap operations
      Minimum/maximum operations
      (C++11)
      (C++17)
      Lexicographical comparison operations
      Permutation operations
      C library
      Numeric operations
      Operations on uninitialized memory
       
      Defined in header<algorithm>
      template<class ForwardIt,class Generator>
      void generate( ForwardIt first, ForwardIt last, Generator g);
      (1)(constexpr since C++20)
      template<class ExecutionPolicy,class ForwardIt,class Generator>

      void generate( ExecutionPolicy&& policy,

                     ForwardIt first, ForwardIt last, Generator g);
      (2)(since C++17)
      1) Assigns each element in range[firstlast) a value generated by the given function objectg.
      2) Same as(1), but executed according topolicy.
      This overload participates in overload resolution only if all following conditions are satisfied:

      std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> istrue.

      (until C++20)

      std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> istrue.

      (since C++20)

      Contents

      [edit]Parameters

      first, last - the pair of iterators defining therange of elements to generate
      policy - theexecution policy to use
      g - generator function object that will be called.

      The signature of the function should be equivalent to the following:

      Ret fun();

      The typeRet must be such that an object of typeForwardIt can be dereferenced and assigned a value of typeRet.​

      Type requirements
      -
      ForwardIt must meet the requirements ofLegacyForwardIterator.

      [edit]Complexity

      Exactlystd::distance(first, last) invocations ofg() and assignments.

      [edit]Exceptions

      The overload with a template parameter namedExecutionPolicy reports errors as follows:

      • If execution of a function invoked as part of the algorithm throws an exception andExecutionPolicy is one of thestandard policies,std::terminate is called. For any otherExecutionPolicy, the behavior is implementation-defined.
      • If the algorithm fails to allocate memory,std::bad_alloc is thrown.

      [edit]Possible implementation

      template<class ForwardIt,class Generator>constexpr//< since C++20void generate(ForwardIt first, ForwardIt last, Generator g){for(; first!= last;++first)*first= g();}

      [edit]Example

      Run this code
      #include <algorithm>#include <iostream>#include <vector> void println(std::string_view fmt,constauto& v){for(std::cout<< fmt;constauto& e: v)std::cout<< e<<' ';std::cout<<'\n';};  int f(){staticint i;return++i;} int main(){std::vector<int> v(5);     std::generate(v.begin(), v.end(), f);    println("v: ", v); // Initialize with default values 0,1,2,3,4 from a lambda function// Equivalent to std::iota(v.begin(), v.end(), 0);    std::generate(v.begin(), v.end(),[n=0]() mutable{return n++;});    println("v: ", v);}

      Output:

      v: 1 2 3 4 5v: 0 1 2 3 4

      [edit]See also

      copy-assigns the given value to every element in a range
      (function template)[edit]
      assigns the results of successive function calls to N elements in a range
      (function template)[edit]
      (C++11)
      fills a range with successive increments of the starting value
      (function template)[edit]
      saves the result of a function in a range
      (algorithm function object)[edit]
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/algorithm/generate&oldid=180367"

      [8]ページ先頭

      ©2009-2025 Movatter.jp