Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.
PrevUpHomeNext
object::erase (1 of 2 overloads)

Erase an element.

Synopsis
iterator
erase(
    const_iterator pos);
Description

Remove the element pointed to by pos, which must be valid and dereferenceable. Thus the end() iterator (which is valid but cannot be dereferenced) cannot be used as a value for pos. References and iterators to the erased element are invalidated. Other iterators and references are not invalidated.

Complexity

Constant on average, worst case linear in size().

Exception Safety

No-throw guarantee.

Return Value

An iterator following the last removed element.

Parameters

Name

Description

pos

An iterator pointing to the element to be removed.


PrevUpHomeNext