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

Prepends the given element value to the beginning of the container.

No iterators or references are invalidated.

Parameters

Return value

(none)

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("abc");
    std::string s{"def"};
    letters.push_front(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: "def" "abc"
Moved-from string s holds: ""

See also