public member function

std::array::cend

<array>
const_iterator cend() const noexcept;
Return const_iterator to end
Returns a const_iterator pointing to the past-the-end element in the array container.

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.

Parameters

none

Return Value

A const_iterator to the past-the-end location of the sequence.

Member type const_iterator is a random access iterator type.

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 << std::endl;

  return 0;
}


Output:
myarray contains: 15 720 801 1002 3502

Complexity

Constant.

Iterator validity

No changes.

See also