std::array::cend

const_iterator cend() const noexcept;

Returns a const_iterator pointing to the past-the-end element in the array container.

返回一个const属性的超尾迭代器。

A const_iterator is an iterator that points to const content. This iterator can be increased and decreased (unless it is itself also const), just like the iterator returned by array::end,
but it cannot be used to modify the contents it points to, even if the array object is not itself const.

一个const_iterator是一个类似指向常量的iterator,这个迭代器可以递增以及递减（除非该迭代器自己也是cosnt的），返回值和end获得的差不多，但是不能用于修改其内容，即使该array不是const的。

Parameters

none

Return Value

A const_iterator to the past-the-end location of the sequence.
返回const属性的一个超尾迭代器。
Member type const_iterator is a random access iterator type that points to a const element.
迭代器的类型属于随机访问迭代器。

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// array::cend example
#include <iostream>
#include <array>

int main ()
{
  std::array<int,5> myarray = { 15, 720, 801, 1002, 3502 };

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

  std::cout << '\n';

  return 0;
}

Output:

myarray contains: 15 720 801 1002 3502

Complexity

Constant.

Iterator validity

No changes.

Data races

No contained elements are accessed by the call, but the iterator returned can be used to access them. Concurrently accessing or modifying different elements is safe.

容器的元素不会被访问，但是返回的迭代器可以被用来访问元素，同时访问以及修改其他元素是安全的。

Exception safety

No-throw guarantee: this member function never throws exceptions.
The copy construction or assignment of the returned iterator is also guaranteed to never throw.