Namespaces
Variants

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

From cppreference.net

void push_front ( const T & value ) ;
(1) (自 C++11 起)
(自 C++26 起为 constexpr)
void push_front ( T && value ) ;
(2) (自 C++11 起)
(自 C++26 起为 constexpr)

value 的副本添加到容器起始位置。

不会使任何迭代器或引用失效。

目录

参数

value - 要前置插入的元素值
类型要求
-
若满足下列条件,则行为未定义:
1) T 不满足 CopyInsertable forward_list
2) T 不满足 MoveInsertable forward_list

复杂度

常量。

异常

若因任何原因抛出异常,这些函数将不产生任何效果( 强异常安全保证 )。

示例

#include <forward_list>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::forward_list<std::string> letters;
    letters.push_front("me"); // 重载 (1)
    std::string s{"send"};
    letters.push_front(std::move(s)); // 重载 (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: ""

参见

在容器头部就地构造元素
(公开成员函数)
移除首元素
(公开成员函数)
创建从参数推断类型的 std::front_insert_iterator
(函数模板)