最終更新日時(UTC): 2026年02月17日 14時22分33秒
Akira Takahashi が更新

履歴 編集

function template
<unordered_map>

# std::unordered_map::insert_range(C++23)

    template <container-compatible-range<value_type> R>
    void insert_range(R&& rg);           // (1) C++23
    template <container-compatible-range<value_type> R>
    constexpr void insert_range(R&& rg); // (1) C++26

## 概要

コンテナにRange`rg` の要素を挿入する。

## 効果

Range`rg` のすべての要素 `t` に対して、`insert(t)` を呼び出した場合と等価。

## 事前条件

`*this` の要素の範囲と Range`rg` の要素の範囲が重複していないこと

## テンプレートパラメータ制約

`value_type` は、コンテナに対して `EmplaceConstructible` であること

## 戻り値

なし

## 計算量

`N = ranges::distance(rg)` とすると、平均的なケースでは `O(N)`、最悪のケースでは `O(N size() + 1)`。

## 例

    #include <iostream>
    #include <unordered_map>
    #include <utility>
    #include <vector>

    int main ()
    {
        std::unordered_map<char, int> m = {{'A', 10}, {'B', 11}};

        std::vector<std::pair<char,int>> v = {{'B', 11}, {'C', 12}};
        m.insert_range(v);

        for (const auto& kv : m) {
            std::cout << kv.first << " " << kv.second << std::endl;
        }

        return 0;
    }

### 出力例

    C 12
    B 11
    A 10

注：`unordered_map` は非順序連想コンテナであるため、出力順序は無意味であることに注意

## 関連項目

名前 | 説明
--- | ---
`insert` | 要素の追加
`insert_or_assign` | 要素の追加、あるいは代入

## 参照

- P3372R3 constexpr containers and adaptors