std::forward_list<T,Allocator>::assign
来自 cppreference.cn
< cpp | 容器 | forward_list
void assign( size_type count, const T& value ); |
(1) | (C++11 起) |
template< class InputIt > void assign( InputIt first, InputIt last ); |
(2) | (C++11 起) |
void assign( std::initializer_list<T> ilist ); |
(3) | (C++11 起) |
替换容器的内容。
1) 将内容替换为 count 个 value 的副本。
2) 将内容替换为范围
[
first,
last)
中的副本。 如果任一参数是 *this 的迭代器,则行为是未定义的。
如果 |
(C++11 前) |
此重载仅在 `InputIt` 满足 LegacyInputIterator 时参与重载决议。 |
(C++11 起) |
3) 将内容替换为 ilist 中的元素。
容器中所有迭代器、指针和元素的引用都将失效。
目录 |
[编辑] 参数
count | - | 容器的新大小 |
value | - | 用于初始化容器元素的数值 |
first, last | - | 定义要复制的元素的源 范围 的迭代器对 |
ilist | - | std::initializer_list,从中复制值 |
[编辑] 复杂度
1) 关于 count 的线性复杂度。
2) 关于 first 和 last 之间距离的线性复杂度。
3) 关于 ilist.size() 的线性复杂度。
[编辑] 示例
以下代码使用 `assign` 向 std::forward_list<char> 添加多个字符。
运行此代码
#include <forward_list> #include <iostream> #include <string> int main() { std::forward_list<char> characters; auto print_forward_list = [&]() { for (char c : characters) std::cout << c << ' '; std::cout << '\n'; }; characters.assign(5, 'a'); print_forward_list(); const std::string extra(6, 'b'); characters.assign(extra.begin(), extra.end()); print_forward_list(); characters.assign({'C', '+', '+', '1', '1'}); print_forward_list(); }
输出
a a a a a b b b b b b C + + 1 1
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
---|---|---|---|
LWG 2209 | C++11 | 替换操作要求实现为 擦除所有现有元素,然后插入给定元素 |
移除了冗余要求 要求 |
[编辑] 参阅
(C++23) |
将一个范围的值赋给容器 (public member function) |
将值赋给容器 (public member function) |