std::ranges::fill
来自 cppreference.com
在头文件 <algorithm> 中定义 |
||
调用签名 |
||
(1) | ||
template< class T, std::output_iterator<const T&> O, std::sentinel_for<O> S > constexpr O fill( O first, S last, const T& value ); |
(自 C++20 起) (直到 C++26) |
|
template< class O, std::sentinel_for<O> S, class T = std::iter_value_t<O> > requires std::output_iterator<O, const T&> |
(自 C++26 起) | |
(2) | ||
template< class T, ranges::output_range<const T&> R > constexpr ranges::borrowed_iterator_t<R> fill( R&& r, const T& value ); |
(自 C++20 起) (直到 C++26) |
|
template< class R, class T = ranges::range_value_t<R> > requires ranges::output_range<R, const T&> |
(自 C++26 起) | |
1) 将给定的 value 赋值给范围
[
first,
last)
中的元素。此页面上描述的函数式实体是 niebloids,即
实际上,它们可以作为函数对象实现,或者使用特殊的编译器扩展实现。
内容 |
[编辑] 参数
first, last | - | 要修改的元素范围 |
r | - | 要修改的元素范围 |
value | - | 要分配的值 |
[编辑] 返回值
一个与 last 相等的输出迭代器。
[编辑] 复杂度
正好 last - first 次赋值。
[编辑] 可能的实现
struct fill_fn { template<class O, std::sentinel_for<O> S, class T = std::iter_value_t<O>> requires std::output_iterator<O, const T&> constexpr O operator()(O first, S last, const T& value) const { while (first != last) *first++ = value; return first; } template<class R, class T = ranges::range_value_t<R>> requires ranges::output_range<R, const T&> constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, const T& value) const { return (*this)(ranges::begin(r), ranges::end(r), value); } }; inline constexpr fill_fn fill; |
[编辑] 备注
特性测试 宏 | 值 | Std | 特性 |
---|---|---|---|
__cpp_lib_algorithm_default_value_type |
202403 | (C++26) | 列表初始化 用于算法 (1,2) |
[编辑] 示例
运行此代码
#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}; // set all elements to -1 using overload (1) std::ranges::fill(v.begin(), v.end(), -1); println(v); // set all element to 10 using overload (2) std::ranges::fill(v, 10); println(v); std::vector<std::complex<double>> nums{{1, 3}, {2, 2}, {4, 8}}; println(nums); #ifdef __cpp_lib_algorithm_default_value_type std::ranges::fill(nums, {4, 2}); // T gets deduced #else std::ranges::fill(nums, std::complex<double>{4, 2}); #endif println(nums); }
输出
-1 -1 -1 -1 -1 -1 10 10 10 10 10 10 (1,3) (2,2) (4,8) (4,2) (4,2) (4,2)
[编辑] 参见
(C++20) |
将值分配给一定数量的元素 (niebloid) |
(C++20)(C++20) |
将元素范围复制到新位置 (niebloid) |
(C++20) |
将函数的结果保存在范围内 (niebloid) |
(C++20) |
将函数应用于元素范围 (niebloid) |
(C++26) |
使用均匀随机位生成器填充范围内的随机数 (niebloid) |
将给定值复制分配给范围内的每个元素 (函数模板) |