public member function
<vector>

std::vector::cend

const_iterator cend() const noexcept;
返回指向结尾的 const_iterator
返回一个const_iterator指向容器的尾后元素。

Aconst_iterator是一个指向常量内容的迭代器。这个迭代器可以像iteratorreturned by vector::end, 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, this function returns the same as vector::cbegin.

返回的值不应被解引用。

参数



返回值

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


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

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

异常安全

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

另见