std::forward_list<T,Allocator>::forward_list
< cpp | container | forward list
forward_list(); |
(1) | |
explicit forward_list( const Allocator& alloc ); |
(2) | |
forward_list( size_type count, const T& value, |
(3) | (C++11 起) |
(4) | ||
explicit forward_list( size_type count ); |
(C++11 起) (C++14 前) |
|
explicit forward_list( size_type count, const Allocator& alloc = Allocator() ); |
(C++14 起) | |
template< class InputIt > forward_list( InputIt first, InputIt last, |
(5) | (C++11 起) |
forward_list( const forward_list& other ); |
(6) | (C++11 起) |
forward_list( const forward_list& other, const Allocator& alloc ); |
(7) | (C++11 起) |
forward_list( forward_list&& other ); |
(8) | (C++11 起) |
forward_list( forward_list&& other, const Allocator& alloc ); |
(9) | (C++11 起) |
forward_list( std::initializer_list<T> init, const Allocator& alloc = Allocator() ); |
(10) | (C++11 起) |
从各种数据源构造新容器,可选地使用用户提供的分配器 alloc
。
1) 默认构造函数。构造拥有默认构造的分配器的空容器。
2) 构造拥有给定分配器
alloc
的空容器。3) 构造拥有
count
个有值 value
的元素的容器。5) 构造拥有范围
[first, last)
内容的容器。
若 |
(C++11 前) |
此重载仅若 |
(C++11 起) |
6) 复制构造函数。构造拥有
other
内容的容器,如同通过调用 std::allocator_traits<allocator_type>::select_on_container_copy_construction(other.get_allocator()) 获得分配器。7) 构造拥有
other
内容的容器,以 alloc
为分配器。8) 移动构造函数。用移动语义构造拥有
other
内容的容器。分配器通过属于 other
的分配器移动构造获得。9) 有分配器扩展的移动构造函数。以
alloc
为新容器的分配器,从 other
移动内容;若 alloc != other.get_allocator() ,则它导致逐元素移动。10) 构造拥有 initializer_list
init
内容的容器。参数
alloc | - | 用于此容器所有内存分配的分配器 |
count | - | 容器的大小 |
value | - | 以之初始化容器元素的值 |
first, last | - | 复制元素的来源范围 |
other | - | 用作初始化容器元素来源的另一容器 |
init | - | 用作初始化元素来源的 initializer_list |
复杂度
1-2) 常数
3-4) 与
count
成线性5) 与
first
和 last
的距离成线性6-7) 与
other
的大小成线性8) 常数。
9) 若 alloc != other.get_allocator() 则为线性,否则为常数。
10) 与
init
的大小成线性。异常
调用 Allocator::allocate
可能抛出。
注解
在容器移动构造(重载 (7) )后,指向 other
的引用及迭代器(除了尾迭代器)保持合法,但指代现于 *this 中的元素。当前标准由 [container.requirements.general]/12 中的总括陈述作出此保证,而 LWG 2321 正在考虑更严格的保证。
示例
运行此代码
#include <forward_list> #include <string> #include <iostream> template<typename T> std::ostream& operator<<(std::ostream& s, const std::forward_list<T>& v) { s.put('['); char comma[3] = {'\0', ' ', '\0'}; for (const auto& e : v) { s << comma << e; comma[0] = ','; } return s << ']'; } int main() { // C++11 初始化器列表语法: std::forward_list<std::string> words1 {"the", "frogurt", "is", "also", "cursed"}; std::cout << "words1: " << words1 << '\n'; // words2 == words1 std::forward_list<std::string> words2(words1.begin(), words1.end()); std::cout << "words2: " << words2 << '\n'; // words3 == words1 std::forward_list<std::string> words3(words1); std::cout << "words3: " << words3 << '\n'; // words4 为 {"Mo", "Mo", "Mo", "Mo", "Mo"} std::forward_list<std::string> words4(5, "Mo"); std::cout << "words4: " << words4 << '\n'; }
输出:
words1: [the, frogurt, is, also, cursed] words2: [the, frogurt, is, also, cursed] words3: [the, frogurt, is, also, cursed] words4: [Mo, Mo, Mo, Mo, Mo]
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
LWG 2193 | C++11 | 默认构造函数为 explicit | 使之为非 explicit |
参阅
将值赋给容器 (公开成员函数) | |
赋值给容器 (公开成员函数) |