C++ Reference: Standard C++ Library reference: Containers: list: list: assign

news2024/11/15 21:35:43

C++官网参考链接：https://cplusplus.com/reference/list/list/assign/

公有成员函数
<list>
std::list::assign
C++98
范围 (1)
template <class InputIterator> void assign (InputIterator first, InputIterator last);
填充 (2)
void assign (size_type n, const value_type& val);
C++11
范围 (1)
template <class InputIterator> void assign (InputIterator first, InputIterator last);
填充 (2)
void assign (size_type n, const value_type& val);
初始化列表 (3)
void assign (initializer_list<value_type> il);
为容器分配新内容
将新内容分配给list容器，替换其当前内容并相应地修改其大小。
C++98
在范围版本(1)中，新内容是由first和last范围中的每个元素以相同的顺序构造的元素。
在填充版本(2)中，新内容是n个元素，每个元素初始化为val的一个副本。
所分配元素所需的任何存储都使用内部allocator（internal allocator）进行分配。
调用之前容器中保存的任何元素都将被销毁并替换为新构造的元素（不发生元素赋值）。
C++11
在范围版本(1)中，新内容是由first和last范围中的每个元素以相同的顺序构造的元素。
在填充版本(2)中，新内容是n个元素，每个元素初始化为val的一个副本。
在初始化列表版本(3)中，新内容是作为初始化列表传递的值的副本，顺序相同。
如果存储发生变化，则使用内部allocator（internal allocator）（通过其traits）。它也被用来destroy所有现有的元素，并construct新的元素。
调用之前容器中保存的任何元素都被赋值或销毁。

形参
first,last
输入iterator到序列的初始和最终位置。使用的范围是[first,last)，它包括first和last之间的所有元素，包括由first指向的元素，但不包括由last指向的元素。
函数模板实参InputIterator应该是一个输入iterator（input iterator）类型，它指向可以构造value_type对象的类型元素。
n
容器的新大小。
成员类型size_type是无符号整型。
val
值来填充容器。容器中的n个元素都将初始化为该值的副本。
成员类型value_type是容器中元素的类型，在list中定义为其第一个模板形参（T）的别名。
il
一个initializer_list对象。编译器将从初始化列表声明器自动构造此类对象。
成员类型value_type是容器中元素的类型，在list中定义为其第一个模板形参（T）的别名。

返回值
没有返回值。

用例
// list::assign
#include <iostream>
#include <list>

int main ()
{
std::list<int> first;
std::list<int> second;

first.assign (7,100); // 7 ints with value 100

second.assign (first.begin(),first.end()); // a copy of first

int myints[]={1776,7,4};
first.assign (myints,myints+3); // assigning from array

std::cout << "Size of first: " << int (first.size()) << '\n';
std::cout << "Size of second: " << int (second.size()) << '\n';
return 0;
}
输出：