المتغيرات
فضاءات التسمية
أفعال

std::{{{1}}}::erase

من cppreference.com
iterator erase( const_iterator pos );
(1) قالب:mark since none
iterator erase( const_iterator first, const_iterator last );
(2) قالب:mark since none
size_type erase( const key_type& key );
(3) قالب:mark since none

Removes specified elements from the container.

1) Removes the element at ‎pos‎.
2) Removes the elements in the range ‎[first; last)‎.
3) Removes all elements with the key value ‎key‎.

Information on iterator invalidation is copied from here

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


محتويات

[تعديل] Parameters

pos - iterator to the element to remove
first, last - range of elements to remove
key - key value of the elements to remove

[تعديل] Return value

1-2) Iterator following the last removed element.
3) Number of elements removed.

[تعديل] Exceptions

1,2) (none)
3) Any exceptions thrown by the ‎Compare‎ object.

[تعديل] Complexity

Given an instance ‎c‎ of ‎{{{1}}}‎:

1) Average case: constant, worst case: c.size()
2) Average case: std::distance(first, last), worst case: c.size()
3) Average case: c.count(key), worst case: c.size()

[تعديل] See also

قالب:dsc mem fun