public member function

std::deque::cbegin

<deque>
const_iterator cbegin() const noexcept;
Return const_iterator to beginning
Returns a const_iterator pointing to the first element in the 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 deque::begin, but it cannot be used to modify the contents it points to.

Unlike deque::begin, this function returns a const_iterator even if the deque object is not itself const.

Parameters

none

Return Value

A const_iterator to the beginning 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
17
// deque::cbegin/cend
#include <iostream>
#include <deque>

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

  std::cout << "mydeque contains:";

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

  std::cout << '\n';

  return 0;
}


Output:
mydeque contains: 10 20 30 40 50

Complexity

Constant.

Iterator validity

No changes.

See also