std::multimap(C++17) | ||||
| Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
| Associative | ||||
| Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
| Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Views | ||||
(C++20) | ||||
(C++23) | ||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
| Member functions | |||||||
| Non-member functions | |||||||
| |||||||
| Deduction guides(C++17) | |||||||
Defined in header <map> | ||
template<class InputIt, class Comp=std::less</*iter-key-t*/<InputIt>>, | (1) | (since C++17) |
template<class Key, class T, | (2) | (since C++17) |
template<class InputIt,class Alloc> multimap( InputIt, InputIt, Alloc) | (3) | (since C++17) |
template<class Key,class T,class Alloc> multimap(std::initializer_list<std::pair<Key, T>>, Alloc) | (4) | (since C++17) |
template<ranges::input_range R,class Compare=std::less</*range-key-t*/<R>, class Alloc=std::allocator</*range-to-alloc-t*/<R>>> | (5) | (since C++23) |
template<ranges::input_range R,class Alloc> multimap(std::from_range_t, R&&, Alloc) | (6) | (since C++23) |
Exposition-only helper type aliases | ||
template<class InputIt> using/*iter-val-t*/= | (exposition only*) | |
template<class InputIt> using/*iter-key-t*/= | (exposition only*) | |
template<class InputIt> using/*iter-mapped-t*/= | (exposition only*) | |
template<class InputIt> using/*iter-to-alloc-t*/= | (exposition only*) | |
template<ranges::input_range Range> using/*range-key-t*/= | (since C++23) (exposition only*) | |
template<ranges::input_range Range> using/*range-mapped-t*/= | (since C++23) (exposition only*) | |
template<ranges::input_range Range> using/*range-to-alloc-t*/= | (since C++23) (exposition only*) | |
multimap to allow deduction from an iterator range (overloads(1,3)) andstd::initializer_list (overloads(2,4)).multimap to allow deduction from astd::from_range_t tag and aninput_range.These overloads participate in overload resolution only ifInputIt satisfiesLegacyInputIterator,Alloc satisfiesAllocator, andComp does not satisfyAllocator.
Note: the extent to which the library determines that a type does not satisfyLegacyInputIterator is unspecified, except that as a minimum integral types do not qualify as input iterators. Likewise, the extent to which it determines that a type does not satisfyAllocator is unspecified, except that as a minimum the member typeAlloc::value_type must exist and the expressionstd::declval<Alloc&>().allocate(std::size_t{}) must be well-formed when treated as an unevaluated operand.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges | 202202L | (C++23) | Ranges-aware construction and insertion; overload(5,6) |
#include <map> int main(){// std::multimap m1 = {{"foo", 1}, {"bar", 2}};// Error: braced-init-list has no type; cannot deduce// pair<Key, T> from {"foo", 1} or {"bar", 2} std::multimap m1={std::pair{"foo",2},{"bar",3}};// guide #2std::multimap m2(m1.begin(), m1.end());// guide #1}
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3025 | C++17 | initializer-list guides(2,4) takestd::pair<const Key, T> | usestd::pair<Key, T> |