(C++17) | ||||
| Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
| Associative | ||||
| Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
| Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Views | ||||
(C++20) | ||||
(C++23) | ||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
| Member types | |||||||||||||||||||||
| Member functions | |||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||
|
| ||||||||||||||||||||
| Deduction guides(C++17) | |||||||||||||||||||||
void push_front(const T& value); | (1) | (constexpr since C++26) |
void push_front( T&& value); | (2) | (since C++11) (constexpr since C++26) |
Prepends a copy ofvalue to the beginning of the container.
All iterators (including theend() iterator) are invalidated. No references are invalidated.
Contents |
| value | - | the value of the element to prepend | ||
| Type requirements | ||||
-
| ||||
Constant.
If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).
#include <deque>#include <iomanip>#include <iostream>#include <string> int main(){std::deque<std::string> letters; letters.push_front("me");// overload (1)std::string s{"send"}; letters.push_front(std::move(s));// overload (2) std::cout<<"std::deque letters holds: ";for(auto&& e: letters)std::cout<<std::quoted(e)<<' '; std::cout<<"\nMoved-from string s holds: "<<std::quoted(s)<<'\n';}
Possible output:
std::deque letters holds: "send" "me"Moved-from string s holds: ""
(C++11) | constructs an element in-place at the beginning (public member function)[edit] |
| adds an element to the end (public member function)[edit] | |
| removes the first element (public member function)[edit] | |
| creates astd::front_insert_iterator of type inferred from the argument (function template)[edit] |
