multimap::erase

Removes an element or a range of elements in a multimap from specified positions or removes elements that match a specified key.

iterator erase(
   const_iterator Where
);
iterator erase(
   const_iterator First,
   const_iterator Last
);
size_type erase(
   const key_type& Key
);

Parameters

  • Where
    Position of the element to be removed.

  • First
    Position of the first element to be removed.

  • Last
    Position just beyond the last element to be removed.

  • Key
    The key of the elements to be removed.

Return Value

For the first two member functions, a bidirectional iterator that designates the first element remaining beyond any elements removed, or an element that is the end of the map if no such element exists.

For the third member function, returns the number of elements that have been removed from the multimap.

Remarks

For a code example, see map::erase.

Requirements

Header: <map>

Namespace: std

See Also

Reference

<map>

multimap Class

multimap::clear

map::max_size, map::clear, map::erase, and map::size

Standard Template Library