header <deque> Deque header Header that defines the deque container class:
Classes deque Double ended queue (class template)
Functions begin Iterator to beginning (function template) end Iterator to end (function template)
https://cplusplus.com/reference/deque/
class template <deque> std::deque template < class T, class Alloc = allocator<T> > class deque; Double ended queue deque (usually pronounced like “deck”) is an irregular acronym of double-ended queue. Double-ended queues are sequence containers with dynamic sizes that can be expanded or contracted on both ends (either its front or its back).
Specific libraries may implement deques in different ways, generally as some form of dynamic array. But in any case, they allow for the individual elements to be accessed directly through random access iterators, with storage handled automatically by expanding and contracting the container as needed.
Therefore, they provide a functionality similar to vectors, but with efficient insertion and deletion of elements also at the beginning of the sequence, and not only at its end. But, unlike vectors, deques are not guaranteed to store all its elements in contiguous storage locations: accessing elements in a deque by offsetting a pointer to another element causes undefined behavior.
Both vectors and deques provide a very similar interface and can be used for similar purposes, but internally both work in quite different ways: While vectors use a single array that needs to be occasionally reallocated for growth, the elements of a deque can be scattered in different chunks of storage, with the container keeping the necessary information internally to provide direct access to any of its elements in constant time and with a uniform sequential interface (through iterators). Therefore, deques are a little more complex internally than vectors, but this allows them to grow more efficiently under certain circumstances, especially with very long sequences, where reallocations become more expensive.
For operations that involve frequent insertion or removals of elements at positions other than the beginning or the end, deques perform worse and have less consistent iterators and references than lists and forward lists.
Container properties Sequence Elements in sequence containers are ordered in a strict linear sequence. Individual elements are accessed by their position in this sequence. Dynamic array Generally implemented as a dynamic array, it allows direct access to any element in the sequence and provides relatively fast addition/removal of elements at the beginning or the end of the sequence. Allocator-aware The container uses an allocator object to dynamically handle its storage needs.
Template parameters T Type of the elements. Aliased as member type deque::value_type. Alloc Type of the allocator object used to define the storage allocation model. By default, the allocator class template is used, which defines the simplest memory allocation model and is value-independent. Aliased as member type deque::allocator_type.
Member types C++98C++11 member type definition notes value_type The first template parameter (T) allocator_type The second template parameter (Alloc) defaults to: allocator<value_type> reference allocator_type::reference for the default allocator: value_type& const_reference allocator_type::const_reference for the default allocator: const value_type& pointer allocator_type::pointer for the default allocator: value_type* const_pointer allocator_type::const_pointer for the default allocator: const value_type* iterator a random access iterator to value_type convertible to const_iterator const_iterator a random access iterator to const value_type reverse_iterator reverse_iterator<iterator> const_reverse_iterator reverse_iterator<const_iterator> difference_type a signed integral type, identical to: iterator_traits<iterator>::difference_type usually the same as ptrdiff_t size_type an unsigned integral type that can represent any non-negative value of difference_type usually the same as size_t
Member functions (constructor) Construct deque container (public member function) (destructor) Deque destructor (public member function) operator= Assign content (public member function)
Iterators: begin Return iterator to beginning (public member function) end Return iterator to end (public member function) rbegin Return reverse iterator to reverse beginning (public member function) rend Return reverse iterator to reverse end (public member function) cbegin Return const_iterator to beginning (public member function) cend Return const_iterator to end (public member function) crbegin Return const_reverse_iterator to reverse beginning (public member function) crend Return const_reverse_iterator to reverse end (public member function)
Capacity: size Return size (public member function) max_size Return maximum size (public member function) resize Change size (public member function) empty Test whether container is empty (public member function) shrink_to_fit Shrink to fit (public member function)
Element access: operator[] Access element (public member function) at Access element (public member function) front Access first element (public member function) back Access last element (public member function)
Modifiers: assign Assign container content (public member function) push_back Add element at the end (public member function) push_front Insert element at beginning (public member function) pop_back Delete last element (public member function) pop_front Delete first element (public member function) insert Insert elements (public member function) erase Erase elements (public member function) swap Swap content (public member function) clear Clear content (public member function) emplace Construct and insert element (public member function) emplace_front Construct and insert element at beginning (public member function) emplace_back Construct and insert element at the end (public member function)
Allocator: get_allocator Get allocator (public member function)
Non-member functions overloads relational operators Relational operators for deque (function) swap Exchanges the contents of two deque containers (function template)