(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_back(const T& value); | (1) | (constexpr since C++26) |
void push_back( T&& value); | (2) | (since C++11) (constexpr since C++26) |
Appends a copy ofvalue to the end of the container.
No iterators or references are invalidated.
Contents |
| value | - | the value of the element to append |
| (since C++11) | ||||||
Constant.
If an exception is thrown (which can be due toAllocator::allocate() or element copy/move constructor/assignment), this function has no effect (strong exception guarantee).
#include <iomanip>#include <iostream>#include <string>#include <list> int main(){std::list<std::string> letters; letters.push_back("abc");std::string s{"def"}; letters.push_back(std::move(s)); std::cout<<"std::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::list letters holds: "abc" "def"Moved-from string s holds: ""
(C++11) | constructs an element in-place at the end (public member function)[edit] |
| inserts an element to the beginning (public member function)[edit] | |
| removes the last element (public member function)[edit] | |
| creates astd::back_insert_iterator of type inferred from the argument (function template)[edit] |
