public member function
<array>

std::array::cbegin

const_iterator cbegin() const noexcept;
返回指向开头的 const_iterator
返回一个const_iterator指向数组容器的第一个元素。

Aconst_iterator是一个指向常量内容的迭代器。这个迭代器可以像iteratorarray::begin 返回,但不能用于修改其指向的内容,即使 array 对象本身不是 const 的。

参数



返回值

Aconst_iterator指向序列的开头。

成员类型const_iterator是一个指向 const 元素的 随机访问迭代器 类型。

示例

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

int main ()
{
  std::array<int,5> myarray = { 2, 16, 77, 34, 50 };

  std::cout << "myarray contains:";

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

  std::cout << '\n';

  return 0;
}

输出
myarray contains: 2 16 77 34 50


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

调用不访问任何容器中的元素,但返回的迭代器可用于访问它们。并发访问或修改不同元素是安全的。

异常安全

无异常保证:此成员函数从不抛出异常。
还可以保证返回的迭代器的复制构造或赋值永远不会引发异常。

另见