Namespaces
Variants

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

From cppreference.net

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

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

所有迭代器(包括 end() 迭代器)都将失效。所有引用保持有效。

目录

参数

value - 要前插元素的值
类型要求
-

若满足以下条件,则行为未定义:

1) T 不可 复制插入 deque
2) T 不可 移动插入 deque
(自 C++11 起)

复杂度

常量。

异常

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

示例

#include <deque>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::deque<std::string> letters;
    letters.push_front("me"); // 重载 (1)
    std::string s{"send"};
    letters.push_front(std::move(s)); // 重载 (2)
    std::cout << "std::deque letters holds: ";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
    std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n';
}

可能的输出:

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

参见

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