C++

參考

<deque>

deque

public member function
<deque>

std::deque::front

      reference front();const_reference front() const;
訪問第一個元素
返回一個對deque容器中第一個元素的引用。

與返回指向相同元素的迭代器的成員函式 deque::begin 不同，此函式返回一個直接引用。

在 empty 容器上呼叫此函式會導致未定義行為。

引數

無

返回值

對deque容器中第一個元素的引用。

如果deque物件被const限定，則函式返回一個const_reference。否則，它返回一個引用.

成員型別引用和const_reference是容器元素引用的型別（參見 deque 成員型別）。

示例

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

int main ()
{
  std::deque<int> mydeque;

  mydeque.push_front(77);
  mydeque.push_back(20);

  mydeque.front() -= mydeque.back();

  std::cout << "mydeque.front() is now " << mydeque.front() << '\n';

  return 0;
}

輸出
mydeque.front() is now 57


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

訪問容器（const 和非 const 版本都不會修改容器）。
第一個元素可以被呼叫者訪問或修改。同時訪問或修改其他元素是安全的。

異常安全

如果容器不為空（不是 empty），則該函式絕不會丟擲異常（無異常保證）。
否則，將導致未定義行為。

另見

deque::back
訪問最後一個元素 (公開成員函式)
deque::begin
返回指向起始位置的迭代器 (公開成員函式)
deque::push_front
在起始位置插入元素 (公開成員函式)
deque::pop_front
刪除第一個元素 (公開成員函式)