Template:cpp/container/erase

Erases the specified elements from the container.

@1@ Removes the element at.

@2@ Removes the elements in the range.

The iterator must be valid and dereferenceable. Thus the end iterator (which is valid, but is not dereferenceable) cannot be used as a value for.

The iterator does not need to be dereferenceable if : erasing an empty range is a no-op.

Return value
Iterator following the last removed element.

@1@ If refers to the last element, then the end iterator is returned.

@2@ If prior to removal, then the updated end iterator is returned.

@@ If is an empty range, then  is returned.