object::stable_erase (1 of 2 overloads)

Erase an element preserving order.

Synopsis

object::iterator
stable_erase(
    object::const_iterator pos) noexcept;

Remove the element pointed to by pos, which must be valid and dereferenceable. References and iterators from pos to end(), both included, are invalidated. Other iterators and references are not invalidated. The relative order of remaining elements is preserved.

Remarks

The end() iterator (which is valid but cannot be dereferenced) cannot be used as a value for pos.

Complexity

Linear in size().

Exception Safety

No-throw guarantee.

Return Value

An iterator following the removed element.

Parameters

Name	Description
`pos`	An iterator pointing to the element to be removed.