std::list<T,Allocator>:: push_back

Appends the given element value to the end of the container.

No iterators or references are invalidated.

Parameters

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

#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';
}

std::list letters holds: "abc" "def"
Moved-from string s holds: ""

See also