deque(); | (1) | |
explicit deque( const Allocator& alloc ); | (2) | |
(3) | ||
explicit deque( size_type count, const T& value = T(), const Allocator& alloc = Allocator()); | (until C++11) | |
deque( size_type count, const T& value, const Allocator& alloc = Allocator()); | (since C++11) | |
(4) | ||
explicit deque( size_type count ); | (since C++11) (until C++14) | |
explicit deque( size_type count, const Allocator& alloc = Allocator() ); | (since C++14) | |
template< class InputIt > deque( InputIt first, InputIt last, const Allocator& alloc = Allocator() ); | (5) | |
deque( const deque& other ); | (6) | |
deque( const deque& other, const Allocator& alloc ); | (7) | (since C++11) |
deque( deque&& other ); | (8) | (since C++11) |
deque( deque&& other, const Allocator& alloc ); | (9) | (since C++11) |
deque( std::initializer_list<T> init, const Allocator& alloc = Allocator() ); | (10) | (since C++11) |
Constructs a new container from a variety of data sources, optionally using a user supplied allocator alloc
.
alloc
.count
copies of elements with value value
.[first, last)
. This constructor has the same effect as | (until C++11) |
This overload participates in overload resolution only if | (since C++11) |
other
. The allocator is obtained as if by calling | (since C++11) |
other
, using alloc
as the allocator. The template parameter | (since C++23) |
other
using move semantics. Allocator is obtained by move-construction from the allocator belonging to other
. alloc
as the allocator for the new container, moving the contents from other
; if alloc != other.get_allocator()
, this results in an element-wise move. The template parameter | (since C++23) |
init
. alloc | - | allocator to use for all memory allocations of this container |
count | - | the size of the container |
value | - | the value to initialize elements of the container with |
first, last | - | the range to copy the elements from |
other | - | another container to be used as source to initialize the elements of the container with |
init | - | initializer list to initialize the elements of the container with |
count
first
and last
other
alloc != other.get_allocator()
, otherwise constant.init
.Calls to Allocator::allocate
may throw.
After container move construction (overload (8)), references, pointers, and iterators (other than the end iterator) to other
remain valid, but refer to elements that are now in *this
. The current standard makes this guarantee via the blanket statement in [container.requirements.general]/12, and a more direct guarantee is under consideration via LWG 2321.
#include <deque> #include <string> #include <iostream> template<typename T> std::ostream& operator<<(std::ostream& s, const std::deque<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 initializer list syntax: std::deque<std::string> words1 {"the", "frogurt", "is", "also", "cursed"}; std::cout << "words1: " << words1 << '\n'; // words2 == words1 std::deque<std::string> words2(words1.begin(), words1.end()); std::cout << "words2: " << words2 << '\n'; // words3 == words1 std::deque<std::string> words3(words1); std::cout << "words3: " << words3 << '\n'; // words4 is {"Mo", "Mo", "Mo", "Mo", "Mo"} std::deque<std::string> words4(5, "Mo"); std::cout << "words4: " << words4 << '\n'; }
Output:
words1: [the, frogurt, is, also, cursed] words2: [the, frogurt, is, also, cursed] words3: [the, frogurt, is, also, cursed] words4: [Mo, Mo, Mo, Mo, Mo]
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 2193 | C++11 | the default constructor is explicit | made non-explicit |
assigns values to the container (public member function) |
|
assigns values to the container (public member function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/deque/deque