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

Prepends a copy of value to the beginning of the container.

No iterators or references are invalidated.

Parameters

Complexity

Constant.

Exceptions

If an exception is thrown for any reason, these functions have no effect ( strong exception safety guarantee ).

Example

#include <list>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::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::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: "send" "me"
Moved-from string s holds: ""

See also