(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 functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deduction guides(C++17) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
void push_front(const T& value); | (1) | (since C++11) (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.
No iterators or references are invalidated.
Contents |
| value | - | the value of the element to prepend |
| Type requirements | ||
| -If the following condition is satisfied, the behavior is undefined: | ||
Constant.
If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).
#include <forward_list>#include <iomanip>#include <iostream>#include <string> int main(){std::forward_list<std::string> letters; letters.push_front("me");// overload (1)std::string s{"send"}; letters.push_front(std::move(s));// overload (2) std::cout<<"std::forward_list 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::forward_list letters holds: "send" "me"Moved-from string s holds: ""
| constructs an element in-place at the beginning (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] |
