FreeBSD Manual Pages
std::list::push_back(3) C++ Standard Libary std::list::push_back(3) NAME std::list::push_back - std::list::push_back Synopsis void push_back( const T& value ); (1) void push_back( T&& value ); (2) (since C++11) Appends the given element value to the end of the container. 1) The new element is initialized as a copy of value. 2) value is moved into the new element. No iterators or references are invalidated. Parameters value - the value of the element to append Type requirements - T must meet the requirements of CopyInsertable in order to use over- load (1). - T must meet the requirements of MoveInsertable in order to use over- load (2). Return value (none) Complexity Constant. Exceptions If an exception is thrown (which can be due to Allocator::allocate() or element copy/move constructor/assignment), this function has no effect (strong exception guarantee). Example // Run this code #include <list> #include <iostream> #include <iomanip> #include <string> 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: "" See also emplace_back constructs an element in-place at the end (C++11) (public member function) push_front inserts an element to the beginning (public member function) pop_back removes the last element (public member function) back_inserter creates a std::back_insert_iterator of type inferred from the argument (function template) http://cppreference.com 2022.07.31 std::list::push_back(3)
NAME | Synopsis | Parameters | Type requirements | Return value | Complexity | Exceptions | Example | Possible output: | See also
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::list::push_back&sektion=3&manpath=FreeBSD+Ports+15.0>