最終更新日時(UTC): 2025年07月14日 14時04分00秒
Koichi Murase が更新

履歴 編集

<unordered_map>

# std::unordered_multimap::推論補助(C++17)

    namespace std {
      // 説明用の型
      template <class InputIterator>
      using iter_key_t = remove_const_t<typename iterator_traits<InputIterator>::value_type::first_type>;
      template <class InputIterator>
      using iter_val_t = typename iterator_traits<InputIterator>::value_type::second_type;
      template <class InputIterator>
      using iter_to_alloc_t = pair<add_const_t<typename iterator_traits<InputIterator>::value_type::first_type>,
                                   typename iterator_traits<InputIterator>::value_type::second_type>;
      template <ranges::input_range Range>
      using range_key_t = remove_const_t<typename ranges::range_value_t<Range>::first_type>;
      template <ranges::input_range Range>
      using range_val_t = typename ranges::range_value_t<Range>::second_type;

      template <class InputIterator,
                class Hash = hash<iter_key_t<InputIterator>>,
                class Pred = equal_to<iter_key_t<InputIterator>>,
                class Allocator = allocator<iter_to_alloc_t<InputIterator>>>
      unordered_multimap(InputIterator, InputIterator, typename see below::size_type = see below,
                    Hash = Hash(), Pred = Pred(), Allocator = Allocator())
        -> unordered_multimap<iter_key_t<InputIterator>,
                              iter_value_t<InputIterator>,
                              Hash, Pred, Allocator>;         // (1)

      template <class Key, class T,
                class Hash = hash<Key>,
                class Pred = equal_to<Key>,
                class Allocator = allocator<pair<const Key, T>>>
      unordered_multimap(initializer_list<pair<Key, T>>,
                    typename see below::size_type = see below,
                    Hash = Hash(), Pred = Pred(), Allocator = Allocator())
        -> unordered_multimap<Key, T, Hash, Pred, Allocator>; // (2)

      template <class InputIterator, class Allocator>
      unordered_multimap(InputIterator, InputIterator, typename see below::size_type, Allocator)
        -> unordered_multimap<
               iter_key_t<InputIterator>,
               iter_val_t<InputIterator>,
               hash<iter_key_t<InputIterator>>,
               equal_to<iter_key_t<InputIterator>>,
               Allocator>;                                    // (3)

      template <class InputIterator, class Allocator>
      unordered_multimap(InputIterator, InputIterator, Allocator)
        -> unordered_multimap<
               iter_key_t<InputIterator>,
               iter_val_t<InputIterator>,
               hash<iter_key_t<InputIterator>>,
               equal_to<iter_key_t<InputIterator>>,
               Allocator>;                                    // (4)

      template <class InputIterator, class Hash, class Allocator>
      unordered_multimap(InputIterator, InputIterator, typename see below::size_type, Hash, Allocator)
        -> unordered_multimap<
               iter_key_t<InputIterator>,
               iter_val_t<InputIterator>,
               Hash,
               equal_to<iter_key_t<InputIterator>>,
               Allocator>;                                    // (5)

      template <class Key, class T, typename Allocator>
      unordered_multimap(initializer_list<pair<Key, T>>, typename see below::size_type, Allocator)
        -> unordered_multimap<Key, T, hash<Key>,
                              equal_to<Key>, Allocator>;      // (6)

      template <class Key, class T, typename Allocator>
      unordered_multimap(initializer_list<pair<Key, T>>, Allocator)
        -> unordered_multimap<Key, T, hash<Key>,
                              equal_to<Key>, Allocator>;      // (7)

      template <class Key, class T, class Hash, class Allocator>
      unordered_multimap(initializer_list<pair<Key, T>>, typename see below::size_type, Hash, Allocator)
        -> unordered_multimap<Key, T, Hash,
                              equal_to<Key>, Allocator>;      // (8)

      template <ranges::input_range R, class Hash = hash<range_key_t<R>>,
               class Pred = equal_to<range_key_t<R>>,
               class Allocator = allocator<range-to-alloc-type<R>>>
      unordered_multimap(from_range_t, R&&, typename see below::size_type = see below,
                         Hash = Hash(), Pred = Pred(), Allocator = Allocator())
        -> unordered_multimap<range_key_t<R>, range_val_t<R>, Hash, Pred, Allocator>; // (9) C++23から

      template <ranges::input_range R, class Allocator>
      unordered_multimap(from_range_t, R&&, typename see below::size_type, Allocator)
        -> unordered_multimap<range_key_t<R>, range_val_t<R>, hash<range_key_t<R>>,
                              equal_to<range_key_t<R>>, Allocator>;                   // (10) C++23から

      template <ranges::input_range R, class Allocator>
      unordered_multimap(from_range_t, R&&, Allocator)
        -> unordered_multimap<range_key_t<R>, range_val_t<R>, hash<range_key_t<R>>,
                              equal_to<range_key_t<R>>, Allocator>;                   // (11) C++23から

      template <ranges::input_range R, class Hash, class Allocator>
      unordered_multimap(from_range_t, R&&, typename see below::size_type, Hash, Allocator)
        -> unordered_multimap<range_key_t<R>, range_val_t<R>, Hash,
                              equal_to<range_key_t<R>>, Allocator>;                   // (12) C++23から
    }

## 概要

`std::unordered_multimap`クラステンプレートの型推論補助。

- (1) : イテレータ範囲からの推論
- (2) : 初期化子リストからの推論
- (3) : イテレータ範囲とバケット数、アロケータからの推論
- (4) : イテレータ範囲とアロケータからの推論
- (5) : イテレータ範囲とバケット数、ハッシュ関数、アロケータからの推論
- (6) : 初期化子リストとバケット数、アロケータからの推論
- (7) : 初期化子リストとアロケータからの推論
- (8) : 初期化子リストとバケット数、ハッシュ関数、アロケータからの推論
- (9) : Rangeからの推論
- (10) : Rangeとバケット数、アロケータからの推論
- (11) : Rangeとアロケータからの推論
- (12) : Rangeとバケット数、ハッシュ関数、アロケータからの推論

## 備考

- メンバ型`size_type`は自動的に推論される
- C++17時点において、`unordered_multimap`の推論補助は使いにくい。これはイテレータ範囲や組でのキーの型が`const Key`となっているためだ。この使いにくさは、将来の言語拡張で改良される可能性がある。

      // コンパイルエラー！ 初期化子リストからconst Keyを導出できない
      unordered_multimap m = {{"foo", 2}, {"bar", 3}, {"baz", 4}};

      // OK
      unordered_multimap m2 = initializer_list<pair<char const *, int>>({{"foo", 2}, {"bar", 3}, {"baz", 4}});

## バージョン

### 言語

- C++17

### 処理系

- Clang:
- GCC:
- Visual C++: ??

## 関連項目

- C++17 クラステンプレートのテンプレート引数推論

## 参照

- P0433R2 Toward a resolution of US7 and US14: Integrating template deduction for class templates into the standard library
- LWG Issue 3025. Map-like container deduction guides should use `pair<Key, T>`, not `pair<const Key, T>`