C++ Standard Library C++ STL Library

C++ <vector> - cend() Function



The C++ vector::cend function returns the constant iterator (const_iterator) pointing to the past-the-last element of the vector container. The past-the-last element of the vector is the theoretical element that follows the last element. It does not point to any element, and hence could not be dereferenced.

C++ cbegin cend

Note: A const_iterator is an iterator that points to constant value. The difference between iterator and const_iterator is that the const_iterator cannot be used to modify the contents it points to, even if the vector element is not itself constant.

Syntax

const_iterator cend() const noexcept;

Parameters

No parameter is required.

Return Value

A const_iterator to the past-the-last element of the sequence container.

Time Complexity

Constant i.e, Θ(1).

Example:

In the example below, the vector::cend function returns the const_iterator pointing to the past-the-last element of the vector MyVector.

#include <iostream>
#include <vector>
using namespace std;
 
int main (){
  vector<string> MyVector{"Alpha","Coding","Skills"};
  vector<string>::const_iterator cit;

  cit = MyVector.cend();
  cit--;
  cout<<*cit<<" ";
  cit--;
  cout<<*cit<<" ";
  cit--;
  cout<<*cit<<" ";
  return 0;
}

The output of the above code will be:

Skills Coding Alpha

Example:

Lets see another example where the vector called MyVector contains integer values and vector::cend function is used with vector::cbegin function to specify a range including all elements of the vector container.

#include <iostream>
#include <vector>
using namespace std;
 
int main (){
  vector<int> MyVector{10, 20, 30, 40, 50};
  vector<int>::const_iterator cit;

  for(cit = MyVector.cbegin(); cit != MyVector.cend(); ++cit)
    cout<<*cit<<" ";

  return 0;
}

The output of the above code will be:

10 20 30 40 50 

❮ C++ <vector> Library

5