std::unordered_multiset::insert_range(C++23)

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

概要

コンテナにRangerg の要素を挿入する。

効果

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

事前条件

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

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

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

戻り値

なし

計算量

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

例

#include <iostream>
#include <unordered_set>
#include <vector>

int main ()
{
    std::unordered_multiset<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 3 2 2 1 

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

関連項目