add append_range, assign_range, insert_range and prepend_range to std::deque

Author: suomesta

reference/deque/deque.md

@@ -48,6 +48,7 @@ namespace std {
 | [`(destructor)`](deque/op_destructor.md)         | デストラクタ   | |
 | [`operator=`](deque/op_assign.md)         | 代入演算子     | |
 | [`assign`](deque/assign.md)               | コンテナに値を代入する | |
+| [`assign_range`](deque/assign_range.md)   | コンテナにRangeの要素を代入する | C++23 |
 | [`get_allocator`](deque/get_allocator.md) | アロケータオブジェクトを取得する | |
 
 
@@ -92,11 +93,14 @@ namespace std {
 | [`clear`](deque/clear.md)                 | 全ての要素を削除する | |
 | [`insert`](deque/insert.md)               | 任意の位置に要素を挿入する | |
 | [`emplace`](deque/emplace.md)             | 任意の位置に要素を直接構築で挿入する | C++11 |
+| [`insert_range`](deque/insert_range.md)   | 任意の位置にRangeの要素を挿入する | C++23 |
 | [`push_back`](deque/push_back.md)         | 末尾に要素を追加する | |
 | [`emplace_back`](deque/emplace_back.md)   | 末尾に要素を直接構築で追加する | C++11 |
+| [`append_range`](deque/append_range.md)   | 末尾にRangeの要素を追加する | C++23 |
 | [`pop_back`](deque/pop_back.md)           | 末尾要素を削除する | |
 | [`push_front`](deque/push_front.md)       | 先頭に要素を追加する | |
 | [`emplace_front`](deque/emplace_front.md) | 先頭に要素を直接構築で追加する | C++11 |
+| [`prepend_range`](deque/prepend_range.md) | 先頭にRangeの要素を追加する | C++23 |
 | [`pop_front`](deque/pop_front.md)         | 先頭要素を削除する | |
 | [`resize`](deque/resize.md)               | 要素数を変更する | |
 | [`erase`](deque/erase.md)                 | 指定した要素を削除する | |

reference/deque/deque/append_range.md

@@ -0,0 +1,65 @@
+# append_range
+* deque[meta header]
+* std[meta namespace]
+* deque[meta class]
+* function template[meta id-type]
+* cpp23[meta cpp]
+
+```cpp
+template <container-compatible-range<T> R>
+void append_range(R&& rg); // C++23
+```
+
+## 概要
+Rangeの要素を末尾へ追加する。
+
+
+## テンプレートパラメータ制約
+型`T`が`*ranges::begin(rg)`から`deque`コンテナへの`EmplaceConstructible`であること。
+
+
+## 効果
+Range`rg`の各要素を、末尾に追加する。
+
+
+## 戻り値
+なし
+
+
+## 計算量
+`N =` [`ranges::distance`](../../iterator/ranges_distance.md)`(rg)`とすると、`N`に比例。Tのコンストラクタは`N`回呼ばれる。
+
+
+## 例
+```cpp example
+#include <deque>
+#include <iostream>
+
+int main()
+{
+  std::deque<int> d = {1, 2, 3};
+  const int a[3] = {4, 5, 6};
+
+  // Rangeを末尾に追加
+  d.append_range(a);
+
+  for (int i : d) {
+    std::cout << i << " ";
+  }
+  std::cout << std::endl;
+}
+```
+* append_range[color ff0000]
+
+### 出力
+```
+1 2 3 4 5 6 
+```
+
+
+## 関連項目
+
+| 名前                                      | 説明                  |
+|-------------------------------------------|----------------------|
+| [`push_back`](push_back.md)               | 末尾に要素を追加する         |
+| [`emplace_back`](emplace_back.md)         | 末尾に要素を直接構築で追加する |

reference/deque/deque/assign_range.md

@@ -0,0 +1,64 @@
+# assign_range
+* deque[meta header]
+* std[meta namespace]
+* deque[meta class]
+* function template[meta id-type]
+* cpp23[meta cpp]
+
+```cpp
+template <container-compatible-range<T> R>
+void assign_range(R&& rg); // C++23
+```
+
+## 概要
+Rangeの各要素を再代入する。
+
+
+## 事前条件
+`*this` の要素の範囲と Range`rg` の要素の範囲が重複していないこと
+
+
+## テンプレートパラメータ制約
+型`T`が`*ranges::begin(rg)`から`deque`コンテナへの`EmplaceConstructible`であること。
+
+
+## 効果
+Range`rg`の各要素を、再代入する。
+
+
+## 戻り値
+なし
+
+
+## 例
+```cpp example
+#include <deque>
+#include <iostream>
+
+int main()
+{
+  std::deque<int> d = {1, 2, 3};
+  const int a[3] = {4, 5, 6};
+
+  // Rangeを再代入
+  d.assign_range(a);
+
+  for (int i : d) {
+    std::cout << i << " ";
+  }
+  std::cout << std::endl;
+}
+```
+* assign_range[color ff0000]
+
+### 出力
+```
+4 5 6 
+```
+
+
+## 関連項目
+
+| 名前                                      | 説明                  |
+|-------------------------------------------|----------------------|
+| [`assign`](assign.md)                     | コンテナに値を代入する   |

reference/deque/deque/insert_range.md

@@ -0,0 +1,62 @@
+# insert_range
+* deque[meta header]
+* std[meta namespace]
+* deque[meta class]
+* function template[meta id-type]
+* cpp23[meta cpp]
+
+```cpp
+template <container-compatible-range<T> R>
+iterator insert_range(const_iterator pos, R&& rg); // C++23
+```
+
+## 概要
+Rangeの各要素を任意の位置に挿入する。
+
+
+## テンプレートパラメータ制約
+型`T`が`*ranges::begin(rg)`から`deque`コンテナへの`EmplaceConstructible`であり、かつ型`T`が`MoveConstructible`・`MoveAssignable`・`Swappable`であること。
+
+
+## 効果
+Range`rg`の各要素を、`pos`の直前に挿入する。
+
+
+## 戻り値
+挿入されたRange`rg`の最初の要素を指すイテレータ。`rg`が空の場合は`pos`。
+
+
+## 例
+```cpp example
+#include <deque>
+#include <iostream>
+#include <iterator>
+
+int main()
+{
+  std::deque<int> d = {1, 2, 3};
+  const int a[3] = {4, 5, 6};
+
+  // Rangeを１番目と２番目の要素の間に挿入
+  d.insert_range(std::next(d.begin()), a);
+
+  for (int i : d) {
+    std::cout << i << " ";
+  }
+  std::cout << std::endl;
+}
+```
+* insert_range[color ff0000]
+
+### 出力
+```
+1 4 5 6 2 3
+```
+
+
+## 関連項目
+
+| 名前                                      | 説明                  |
+|-------------------------------------------|----------------------|
+| [`insert`](insert.md)                     | 任意の位置に要素を挿入する         |
+| [`emplace`](emplace.md)                   | 任意の位置に要素を直接構築で挿入する |

reference/deque/deque/prepend_range.md

@@ -0,0 +1,65 @@
+# prepend_range
+* deque[meta header]
+* std[meta namespace]
+* deque[meta class]
+* function template[meta id-type]
+* cpp23[meta cpp]
+
+```cpp
+template <container-compatible-range<T> R>
+void prepend_range(R&& rg); // C++23
+```
+
+## 概要
+先頭にRangeの要素を追加する。
+
+
+## テンプレートパラメータ制約
+型`T`が`*ranges::begin(rg)`から`deque`コンテナへの`EmplaceConstructible`であること。
+
+
+## 効果
+Range`rg`の各要素を、先頭に追加する。
+
+
+## 戻り値
+なし
+
+
+## 計算量
+`N =` [`ranges::distance`](../../iterator/ranges_distance.md)`(rg)`とすると、`N`に比例。Tのコンストラクタは`N`回呼ばれる。
+
+
+## 例
+```cpp example
+#include <deque>
+#include <iostream>
+
+int main()
+{
+  std::deque<int> d = {1, 2, 3};
+  const int a[3] = {4, 5, 6};
+
+  // Rangeを先頭に追加
+  d.prepend_range(a);
+
+  for (int i : d) {
+    std::cout << i << " ";
+  }
+  std::cout << std::endl;
+}
+```
+* prepend_range[color ff0000]
+
+### 出力
+```
+4 5 6 1 2 3 
+```
+
+
+## 関連項目
+
+| 名前                                      | 説明                  |
+|-------------------------------------------|----------------------|
+| [`push_front`](push_front.md)             | 先頭に要素を追加する         |
+| [`emplace_front`](emplace_front.md)       | 先頭に要素を直接構築で追加する |