public member function
<vector>

std::vector::cbegin

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

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

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

参数



返回值

Aconst_iterator指向序列的开头。

成员类型const_iteratoris a random access iterator type that points to a const element.

示例

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

int main ()
{
  std::vector<int> myvector = {10,20,30,40,50};

  std::cout << "myvector contains:";

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

  return 0;
}

输出
myvector contains: 10 20 30 40 50


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

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

异常安全

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

另见