public member function
<list>

std::list::cend

const_iterator cend() const noexcept;
返回指向結尾的 const_iterator
返回一個const_iterator指向容器的尾後元素。

Aconst_iterator是一個指向常量內容的迭代器。這個迭代器可以像iteratorreturned by list::end, but it cannot be used to modify the contents it points to, even if the list object is not itself const.

If the container is empty, this function returns the same as list::cbegin.

返回的值不應被解引用。

引數



返回值

Aconst_iterator指向序列末尾的元素。

成員型別const_iterator是一個指向 const 元素的雙向迭代器型別。

示例

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

int main ()
{
  std::list<int> mylist = {5,10,15,20};

  std::cout << "mylist contains:";

  for (auto it = mylist.cbegin(); it != mylist.cend(); ++it)
    std::cout << ' ' << *it;

  std::cout << '\n';

  return 0;
}

輸出
mylist contains: 5 10 15 20


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

訪問容器。
呼叫不訪問任何容器中的元素,但返回的迭代器可用於訪問它們。併發訪問或修改不同元素是安全的。

異常安全

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

另見