C++

參考

<deque>

deque

public member function
<deque>

std::deque::end

      iterator end();const_iterator end() const;
      iterator end() noexcept;const_iterator end() const noexcept;
返回指向末尾的迭代器
返回一個迭代器，指向 deque 容器中“尾後”的元素。

“尾後”元素是 deque 容器中最後一個元素之後理論上的元素。它不指向任何元素，因此不應被解引用。

由於標準庫函式使用的範圍不包括其結束迭代器所指向的元素，因此此函式通常與 deque::begin 結合使用，以指定包含容器中所有元素的範圍。

如果容器 為空，則此函式返回的值與 deque::begin 相同。

引數

無

返回值

指向序列末尾之後元素的迭代器。

如果 deque 物件是 const 限定的，則函式返回一個const_iterator。否則，它返回一個iterator.

成員型別iterator和const_iterator是 隨機訪問迭代器 型別（分別指向一個元素和指向一個 const 元素）。

示例

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

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

  for (int i=1; i<=5; i++) mydeque.insert(mydeque.end(),i);

  std::cout << "mydeque contains:";

  std::deque<int>::iterator it = mydeque.begin();

  while (it != mydeque.end() )
    std::cout << ' ' << *it++;

  std::cout << '\n';

  return 0;
}

輸出
mydeque contains: 1 2 3 4 5


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

訪問容器（const 和非 const 版本都不會修改容器）。
呼叫該函式不訪問任何包含的元素，但返回的迭代器可用於訪問或修改元素。併發訪問或修改不同元素是安全的。

異常安全

無異常保證：此成員函式從不丟擲異常。
還可以保證返回的迭代器的複製構造或賦值永遠不會引發異常。

另見

deque::back
訪問最後一個元素 (公開成員函式)
deque::begin
返回指向起始位置的迭代器 (公開成員函式)
deque::rbegin
返回指向反向起始位置的反向迭代器 (公開成員函式)
deque::rend
返回指向反向末尾的反向迭代器 (公開成員函式)