Constrained algorithms and algorithms on ranges(C++20) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Constrained algorithms, e.g.ranges::copy,ranges::sort, ... | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Execution policies(C++17) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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, | (2) | (since C++17) |
[
first,
last)
a value generated by the given function objectg.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 |
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:
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. |
Exactlystd::distance(first, last) invocations ofg() and assignments.
The overload with a template parameter namedExecutionPolicy
reports errors as follows:
ExecutionPolicy
is one of thestandard policies,std::terminate is called. For any otherExecutionPolicy
, the behavior is implementation-defined.template<class ForwardIt,class Generator>constexpr//< since C++20void generate(ForwardIt first, ForwardIt last, Generator g){for(; first!= last;++first)*first= g();} |
#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
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] |
(C++20) | saves the result of a function in a range (algorithm function object)[edit] |