std::forward_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 <forward_list>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::forward_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::forward_list letters holds: ";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
    std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n';
}

std::forward_list letters holds: "send" "me"
Moved-from string s holds: ""

See also