CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Sat, 19 Jul 2025 14:31:45 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/map/multimap/erase/
HTTP/1.1 200 OK
Server: nginx
Date: Sat, 19 Jul 2025 14:31:46 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"8725-mDgZ9dje4Ge1YRXvfGbDYtIlCnM"
Content-Encoding: gzip
Removes elements from the multimap container.
This effectively reduces the container size by the number of elements removed, which are destroyed.
The parameters determine the elements removed:
Member type size_type is an unsigned integral type.
Output:
For the second version (erase(val)), logarithmic in container size, plus linear in the number of elements removed.
For the last version (erase(first,last)), linear in the distance between first and last.
All other iterators, pointers and references keep their validity.
The elements removed are modified. Concurrently accessing other elements is safe, although iterating ranges in the container is not.
Otherwise, if a single element is to be removed, there are no changes in the container in case of exception (strong guarantee).
Otherwise, the container is guaranteed to end in a valid state (basic guarantee).
If an invalid position or range is specified, it causes undefined behavior.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
multimap
- multimap::~multimap
- multimap::multimap
member functions
- multimap::begin
-
multimap::cbeginC++11
-
multimap::cendC++11
- multimap::clear
- multimap::count
-
multimap::crbeginC++11
-
multimap::crendC++11
-
multimap::emplaceC++11
-
multimap::emplace_hintC++11
- multimap::empty
- multimap::end
- multimap::equal_range
- multimap::erase
- multimap::find
- multimap::get_allocator
- multimap::insert
- multimap::key_comp
- multimap::lower_bound
- multimap::max_size
- multimap::operator=
- multimap::rbegin
- multimap::rend
- multimap::size
- multimap::swap
- multimap::upper_bound
- multimap::value_comp
non-member overloads
public member function
<map>
std::multimap::erase
(1) | void erase (iterator position); |
---|---|
(2) | size_type erase (const key_type& k); |
(3) | void erase (iterator first, iterator last); |
(1) | iterator erase (const_iterator position); |
---|---|
(2) | size_type erase (const key_type& k); |
(3) | iterator erase (const_iterator first, const_iterator last); |
Erase elements
This effectively reduces the container size by the number of elements removed, which are destroyed.
The parameters determine the elements removed:
Parameters
- position
- Iterator pointing to a single element to be removed from the multimap.
Member types iterator and const_iterator are bidirectional iterator types that point to elements. - k
- Key to be removed from the multimap. All elements with a key equivalent to this are removed from the container.
Member type key_type is the type of the elements in the container, defined in multimap as an alias of its first template parameter (Key). - first, last
- Iterators specifying a range within the multimap container to be removed: [first,last). i.e., the range includes all the elements between first and last, including the element pointed by first but not the one pointed by last.
Member types iterator and const_iterator are bidirectional iterator types that point to elements.
Return value
For the key-based version (2), the function returns the number of elements erased.Member type size_type is an unsigned integral type.
The other versions return no value.
The other versions return an iterator to the element that follows the last element removed (or multimap::end, if the last element was removed).
Member type iterator is a bidirectional iterator type that points to an element.
Member type iterator is a bidirectional iterator type that points to an element.
Example
|
|
a => 10 b => 30 c => 40 |
Complexity
For the first version (erase(position)), amortized constant.For the second version (erase(val)), logarithmic in container size, plus linear in the number of elements removed.
For the last version (erase(first,last)), linear in the distance between first and last.
Iterator validity
Iterators, pointers and references referring to elements removed by the function are invalidated.All other iterators, pointers and references keep their validity.
Data races
The container is modified.The elements removed are modified. Concurrently accessing other elements is safe, although iterating ranges in the container is not.
Exception safety
Unless the container's comparison object throws, this function never throws exceptions (no-throw guarantee).Otherwise, if a single element is to be removed, there are no changes in the container in case of exception (strong guarantee).
Otherwise, the container is guaranteed to end in a valid state (basic guarantee).
If an invalid position or range is specified, it causes undefined behavior.
See also
- multimap::clear
- Clear content (public member function)
- multimap::insert
- Insert element (public member function)
- multimap::find
- Get iterator to element (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us