std::unordered_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 |
std::unordered_multimap| Member types | ||||||
| Member functions | ||||||
| Non-member functions | ||||||
| ||||||
| Deduction guides(C++17) | ||||||
Defined in header <unordered_map> | ||
template<class InputIt, class Hash=std::hash</*iter-key-t*/<InputIt>>, | (1) | (since C++17) |
template<class Key,class T,class Hash=std::hash<Key>, class Pred=std::equal_to<Key>, | (2) | (since C++17) |
template<class InputIt,class Alloc> unordered_multimap( InputIt, InputIt,typename/* see below */::size_type, Alloc) | (3) | (since C++17) |
template<class InputIt,class Alloc> unordered_multimap( InputIt, InputIt, Alloc) | (4) | (since C++17) |
template<class InputIt,class Hash,class Alloc> unordered_multimap( InputIt, InputIt,typename/* see below */::size_type, Hash, | (5) | (since C++17) |
template<class Key,class T,typename Alloc> unordered_multimap(std::initializer_list<std::pair<Key, T>>, | (6) | (since C++17) |
template<class Key,class T,typename Alloc> unordered_multimap(std::initializer_list<std::pair<Key, T>>, Alloc) | (7) | (since C++17) |
template<class Key,class T,class Hash,class Alloc> unordered_multimap(std::initializer_list<std::pair<Key, T>>, | (8) | (since C++17) |
template<ranges::input_range R, class Hash=std::hash</*range-key-t*/<R>>, | (9) | (since C++23) |
template<ranges::input_range R,class Alloc> unordered_multimap(std::from_range_t, R&&, | (10) | (since C++23) |
template<ranges::input_range R,class Alloc> unordered_multimap(std::from_range_t, R&&, Alloc) | (11) | (since C++23) |
template<ranges::input_range R,class Hash,class Alloc> unordered_multimap(std::from_range_t, R&&,typename/* see below */::size_type, | (12) | (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*) | |
unordered_multimap to allow deduction from an iterator range (overloads(1,3-5)) andstd::initializer_list (overloads(2,6-8)).unordered_multimap to allow deduction from astd::from_range_t tag and aninput_range.These overloads participate in overload resolution only ifInputIt satisfiesLegacyInputIterator,Alloc satisfiesAllocator, neitherHash norPred satisfyAllocator, andHash is not an integral type.
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.
Thesize_type parameter type in these guides in an refers to thesize_type member type of the type deduced by the deduction guide.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges | 202202L | (C++23) | Ranges-aware construction and insertion; overloads(9-12) |
#include <unordered_map> int main(){// std::unordered_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::unordered_multimap m1={std::pair{"foo",2},{"bar",3}};// guide #2std::unordered_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) and(6-8) takestd::pair<const Key, T> | usestd::pair<Key, T> |