add insert_range to std::unordered_set and std::unordered_multiset (#1069)

Author: suomesta

reference/unordered_set/unordered_multiset.md

@@ -99,6 +99,7 @@ namespace std {
 | [`emplace`](unordered_multiset/emplace.md)           | コンテナ内への要素の直接構築                           | C++11 |
 | [`emplace_hint`](unordered_multiset/emplace_hint.md) | 挿入位置のヒントを使用したコンテナ内への要素の直接構築 | C++11 |
 | [`insert`](unordered_multiset/insert.md)             | 要素の追加                                             | C++11 |
+| [`insert_range`](unordered_multiset/insert_range.md) | Rangeの要素を挿入する                                   | C++23 |
 | [`erase`](unordered_multiset/erase.md)               | 要素の削除                                             | C++11 |
 | [`clear`](unordered_multiset/clear.md)               | 全要素の削除                                           | C++11 |
 | [`swap`](unordered_multiset/swap.md)                 | 内容の交換                                             | C++11 |

reference/unordered_set/unordered_multiset/insert_range.md

@@ -0,0 +1,71 @@
+# insert_range
+* unordered_set[meta header]
+* std[meta namespace]
+* unordered_multiset[meta class]
+* function template[meta id-type]
+* cpp23[meta cpp]
+
+```cpp
+template <container-compatible-range<value_type> R>
+void insert_range(R&& rg); // C++23
+```
+
+## 概要
+コンテナにRange`rg` の要素を挿入する。
+
+
+## 効果
+Range`rg` のすべての要素 `t` に対して、`insert(t)` を呼び出した場合と等価。
+
+
+## 事前条件
+`*this` の要素の範囲と Range`rg` の要素の範囲が重複していないこと
+
+
+## テンプレートパラメータ制約
+`value_type` は、コンテナに対して `EmplaceConstructible` であること
+
+
+## 戻り値
+なし
+
+
+## 計算量
+`N =` [`ranges::distance`](../../iterator/ranges_distance.md)`(rg)` とすると、平均的なケースでは `O(N)`、最悪のケースでは `O(N size() + 1)`。
+
+
+## 例
+```cpp example
+#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;
+}
+```
+* insert_range[color ff0000]
+
+### 出力
+```
+4 3 3 2 2 1 
+```
+注：[`unordered_multiset`](/reference/unordered_set/unordered_multiset.md) は非順序連想コンテナであるため、出力順序は無意味であることに注意
+
+
+## 関連項目
+
+| 名前                                      | 説明                  |
+|-------------------------------------------|----------------------|
+| [`insert`](insert.md)                     | 要素の追加             |

reference/unordered_set/unordered_set.md

@@ -97,6 +97,7 @@ namespace std {
 | [`emplace`](unordered_set/emplace.md)           | コンテナ内への要素の直接構築                           | C++11 |
 | [`emplace_hint`](unordered_set/emplace_hint.md) | 挿入位置のヒントを使用したコンテナ内への要素の直接構築 | C++11 |
 | [`insert`](unordered_set/insert.md)             | 要素の追加                                             | C++11 |
+| [`insert_range`](unordered_set/insert_range.md) | Rangeの要素を挿入する                                   | C++23 |
 | [`erase`](unordered_set/erase.md)               | 要素の削除                                             | C++11 |
 | [`clear`](unordered_set/clear.md)               | 全要素の削除                                           | C++11 |
 | [`swap`](unordered_set/swap.md)                 | 内容の交換                                             | C++11 |

reference/unordered_set/unordered_set/insert_range.md

@@ -0,0 +1,71 @@
+# insert_range
+* unordered_set[meta header]
+* std[meta namespace]
+* unordered_set[meta class]
+* function template[meta id-type]
+* cpp23[meta cpp]
+
+```cpp
+template <container-compatible-range<value_type> R>
+void insert_range(R&& rg); // C++23
+```
+
+## 概要
+コンテナにRange`rg` の要素を挿入する。
+
+
+## 効果
+Range`rg` のすべての要素 `t` に対して、`insert(t)` を呼び出した場合と等価。
+
+
+## 事前条件
+`*this` の要素の範囲と Range`rg` の要素の範囲が重複していないこと
+
+
+## テンプレートパラメータ制約
+`value_type` は、コンテナに対して `EmplaceConstructible` であること
+
+
+## 戻り値
+なし
+
+
+## 計算量
+`N =` [`ranges::distance`](../../iterator/ranges_distance.md)`(rg)` とすると、平均的なケースでは `O(N)`、最悪のケースでは `O(N size() + 1)`。
+
+
+## 例
+```cpp example
+#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;
+}
+```
+* insert_range[color ff0000]
+
+### 出力
+```
+4 3 2 1 
+```
+注：[`unordered_set`](/reference/unordered_set/unordered_set.md) は非順序連想コンテナであるため、出力順序は無意味であることに注意
+
+
+## 関連項目
+
+| 名前                                      | 説明                  |
+|-------------------------------------------|----------------------|
+| [`insert`](insert.md)                     | 要素の追加             |