C++ Vector Library - erase() Function

---

---

Description

The C++ function std::vector::erase() removes single element from the the vector.

This member function modifies size of vector.

Declaration

Following is the declaration for std::vector::erase() function form std::vector header.

C++98

 iterator erase (iterator position); 

C++11

 iterator erase (const_iterator position); 

Parameters

position − Iterator points to the vector element.

Return value

Returns a random access iterator.

Exceptions

If position is invalid then behavior is undefined.

Time complexity

Linear i.e. O(n)

Example

The following example shows the usage of std::vector::erase() function.

 #include <iostream> #include <vector> using namespace std; int main(void) { vector<int> v = {1, 2, 3, 4, 5}; cout << "Original vector" << endl; for (auto it = v.begin(); it != v.end(); ++it) cout << *it << endl; /* Remove first element */ v.erase(v.begin()); cout << "Modified vector" << endl; for (auto it = v.begin(); it != v.end(); ++it) cout << *it << endl; return 0; } 

Let us compile and run the above program, this will produce the following result −

 Original vector 1 2 3 4 5 Modified vector 2 3 4 5