public member function
<forward_list>

std::forward_list::cbegin

const_iterator cbegin() const noexcept;
返回指向開頭的 const_iterator
返回一個const_iterator指向容器中的第一個元素。

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

If the container is empty, the returned iterator value shall not be dereferenced.

引數



返回值

Aconst_iterator指向序列的開頭。

成員型別const_iterator是一個指向 const 元素的 forward iterator 型別。

示例

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

int main ()
{
  std::forward_list<int> mylist = { 21, 32, 12 };

  std::cout << "myarray contains:";
  for ( auto it = mylist.cbegin(); it != mylist.cend(); ++it )
    std::cout << ' ' << *it;   // cannot modify *it

  std::cout << '\n';

  return 0;
}

輸出
mylist contains: 21 32 12


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

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

異常安全

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

另見