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

履歴 編集

function template
<unordered_set>

# std::unordered_set::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_set>
    #include <vector>

    int main ()
    {
        std::unordered_set<int> s = {1, 2, 3};

        std::vector<int> v = {2, 3, 4};
        s.insert_range(v);

        for (int i : s) {
            std::cout << i << " ";
        }
        std::cout << std::endl;

        return 0;
    }

### 出力例

    4 3 2 1

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

## 関連項目

名前 | 説明
--- | ---
`insert` | 要素の追加

## 参照

- P3372R3 constexpr containers and adaptors