C++

參考

<deque>

deque

public member function
<deque>

std::deque::emplace_front

template <class... Args>  void emplace_front (Args&&... args);
在列表開頭構造並插入元素
在 deque 的開頭，當前第一個元素之前插入一個新元素。此新元素使用 args 作為構造引數就地構造。

這會將容器的 size 有效地增加一。

透過呼叫轉發 args 的 allocator_traits::construct 來就地構造元素。

存在一個類似的成員函式 push_front，它將一個現有物件複製或移動到容器中。

引數

args
轉發給構造新元素的引數。

返回值

無。

新元素的儲存使用allocator_traits<allocator_type>::construct()分配，這在失敗時可能會丟擲異常（對於預設的 allocator，bad_alloc如果分配請求不成功，則丟擲）。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
// deque::emplace_from
#include <iostream>
#include <deque>

int main ()
{
  std::deque<int> mydeque = {10,20,30};

  mydeque.emplace_front (111);
  mydeque.emplace_front (222);

  std::cout << "mydeque contains:";
  for (auto& x: mydeque)
    std::cout << ' ' << x;
  std::cout << '\n';

  return 0;
}
輸出
mydeque contains: 222 111 10 20 30


複雜度

常量。

迭代器有效性

與此容器相關的所有迭代器都將失效，但指標和引用保持有效，指向呼叫前它們所指向的相同元素。

資料競爭

容器被修改。
呼叫不訪問任何容器元素：併發訪問或修改它們是安全的（但請參見上面的迭代器有效性）。

異常安全

強保證：如果丟擲異常，容器沒有發生變化。
如果 allocator_traits::construct 不支援相應的引數，則會導致未定義行為。

另見

deque::emplace_back
在末尾構造並插入元素 (公開成員函式)
deque::push_front
在起始位置插入元素 (公開成員函式)
deque::emplace
構造並插入元素 (公開成員函式)
deque::erase
擦除元素 (公開成員函式)
deque::assign
賦值容器內容 (public member function)