template< class ForwardIt, class T >
void fill( ForwardIt first, ForwardIt last, const T& value );
<ForwardIt>::value_type >
constexpr void fill( ForwardIt first, ForwardIt last,
void fill( ExecutionPolicy&& policy,
class ForwardIt, class T = typename std::iterator_traits
<ForwardIt>::value_type >
void fill( ExecutionPolicy&& policy,
1) Assigns the given value to all elements in the range [
first,
last)
.
2) Same as (1), but executed according to policy.
This overload participates in overload resolution only if all following conditions are satisfied:
If value is not writable to first, the program is ill-formed.
[edit] Parameters first, last - the pair of iterators defining the range of elements to modify value - the value to be assigned policy - the execution policy to use Type requirements -ForwardIt
must meet the requirements of LegacyForwardIterator. [edit] Complexity
Exactly std::distance(first, last) assignments.
[edit] ExceptionsThe overload with a template parameter named ExecutionPolicy
reports errors as follows:
ExecutionPolicy
is one of the standard policies, std::terminate is called. For any other ExecutionPolicy
, the behavior is implementation-defined.template<class ForwardIt, class T = typename std::iterator_traits<ForwardIt>::value_type> void fill(ForwardIt first, ForwardIt last, const T& value) { for (; first != last; ++first) *first = value; }[edit] Notes [edit] Example
#include <algorithm> #include <complex> #include <iostream> #include <vector> void println(const auto& seq) { for (const auto& e : seq) std::cout << e << ' '; std::cout << '\n'; } int main() { std::vector<int> v{0, 1, 2, 3, 4, 5, 6, 7, 8}; println(v); // set all of the elements to 8 std::fill(v.begin(), v.end(), 8); println(v); std::vector<std::complex<double>> nums{{1, 3}, {2, 2}, {4, 8}}; println(nums); #ifdef __cpp_lib_algorithm_default_value_type std::fill(nums.begin(), nums.end(), {4, 2}); #else std::fill(nums.begin(), nums.end(), std::complex<double>{4, 2}); #endif println(nums); }
Output:
0 1 2 3 4 5 6 7 8 8 8 8 8 8 8 8 8 8 (1,3) (2,2) (4,8) (4,2) (4,2) (4,2)[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR Applied to Behavior as published Correct behavior LWG 283 C++98T
was required to be CopyAssignable, but
T
is not always writable to ForwardIt
required to be writable instead [edit] See also copy-assigns the given value to N elements in a range
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4