std::vector<T,Allocator>::vector
(1) | ||
vector(); |
(C++17 前) | |
vector() noexcept(noexcept(Allocator())); |
(C++17 起) (C++20 前) |
|
constexpr vector() noexcept(noexcept(Allocator())); |
(C++20 起) | |
(2) | ||
explicit vector( const Allocator& alloc ); |
(C++17 前) | |
explicit vector( const Allocator& alloc ) noexcept; |
(C++17 起) (C++20 前) |
|
constexpr explicit vector( const Allocator& alloc ) noexcept; |
(C++20 起) | |
(3) | ||
explicit vector( size_type count, const T& value = T(), |
(C++11 前) | |
vector( size_type count, const T& value, |
(C++11 起) (C++20 前) |
|
constexpr vector( size_type count, const T& value, |
(C++20 起) | |
(4) | ||
explicit vector( size_type count ); |
(C++11 起) (C++14 前) |
|
explicit vector( size_type count, const Allocator& alloc = Allocator() ); |
(C++14 起) (C++20 前) |
|
constexpr explicit vector( size_type count, const Allocator& alloc = Allocator() ); |
(C++20 起) | |
(5) | ||
template< class InputIt > vector( InputIt first, InputIt last, |
(C++20 前) | |
template< class InputIt > constexpr vector( InputIt first, InputIt last, |
(C++20 起) | |
(6) | ||
vector( const vector& other ); |
(C++20 前) | |
constexpr vector( const vector& other ); |
(C++20 起) | |
(7) | ||
vector( const vector& other, const Allocator& alloc ); |
(C++11 起) (C++20 前) |
|
constexpr vector( const vector& other, const Allocator& alloc ); |
(C++20 起) | |
(8) | ||
vector( vector&& other ); |
(C++11 起) (C++17 前) |
|
vector( vector&& other ) noexcept; |
(C++17 起) (C++20 前) |
|
constexpr vector( vector&& other ) noexcept; |
(C++20 起) | |
(9) | ||
vector( vector&& other, const Allocator& alloc ); |
(C++11 起) (C++20 前) |
|
constexpr vector( vector&& other, const Allocator& alloc ); |
(C++20 起) | |
(10) | ||
vector( std::initializer_list<T> init, const Allocator& alloc = Allocator() ); |
(C++11 起) (C++20 前) |
|
constexpr vector( std::initializer_list<T> init, const Allocator& alloc = Allocator() ); |
(C++20 起) | |
从各种数据源构造新容器,可选地使用用户提供的分配器 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
为分配器。9) 有分配器扩展的移动构造函数。以
alloc
为新容器的分配器,从 other
移动内容;若 alloc != other.get_allocator() ,则它导致逐元素移动。(该情况下,移动后不保证 other
为空)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 正在考虑更严格的保证。
重载 (4) 对如 int 的非类类型元素清零,这与 new[] 将元素保持未初始化的行为不同。为匹配 new[]
的行为,可提供保留元素未初始化的自定义 Allocator::construct
。
示例
运行此代码
#include <vector> #include <string> #include <iostream> template<typename T> std::ostream& operator<<(std::ostream& s, const std::vector<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::vector<std::string> words1 {"the", "frogurt", "is", "also", "cursed"}; std::cout << "words1: " << words1 << '\n'; // words2 == words1 std::vector<std::string> words2(words1.begin(), words1.end()); std::cout << "words2: " << words2 << '\n'; // words3 == words1 std::vector<std::string> words3(words1); std::cout << "words3: " << words3 << '\n'; // words4 为 {"Mo", "Mo", "Mo", "Mo", "Mo"} std::vector<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 |
参阅
将值赋给容器 (公开成员函数) | |
赋值给容器 (公开成员函数) |