basic_string_view::copyを追加

Author: faithandbrave

reference/string_view/basic_string_view.md

@@ -89,7 +89,7 @@ string_view hello = sv.substr(0, 5); // 先頭5文字を抽出する
 
 | 名前 | 説明 | 対応バージョン |
 |------|------|----------------|
-| [`copy`](basic_string_view/copy.md.nolink)                           | 他の文字列にコピーする                         | C++17 |
+| [`copy`](basic_string_view/copy.md)                           | 他の文字列に、自身の文字列をコピーする         | C++17 |
 | [`substr`](basic_string_view/substr.md)                       | 部分文字列を取得する                           | C++17 |
 | [`compare`](basic_string_view/compare.md)                     | 他の文字列との比較を行う                       | C++17 |
 | [`find`](basic_string_view/find.md.nolink)                           | 指定文字列を検索する                           | C++17 |

reference/string_view/basic_string_view/copy.md

@@ -0,0 +1,92 @@
+# copy
+* string_view[meta header]
+* std[meta namespace]
+* basic_string_view[meta class]
+* function[meta id-type]
+* cpp17[meta cpp]
+
+```cpp
+size_type copy(CharT* s, size_type n, size_type pos = 0) const;
+```
+
+## 概要
+他の文字列に、自身の文字列をコピーする。
+
+
+## 要件
+`n`と[`size()`](size.md) `- pos`のうち、小さい方を`rlen`とする。
+
+- `[s, s + rlen)`が妥当な範囲であり、その範囲内の要素にアクセスできること
+
+
+## 効果
+以下と同等の処理を行う：
+
+```cpp
+Traits::copy(s, data() + pos, rlen);
+```
+* copy[link /reference/string/char_traits/copy.md]
+* data()[link data.md]
+
+
+## 戻り値
+`rlen`
+
+
+## 例外
+`pos >` [`size()`](size.md)の場合、[`std::out_of_range`](/reference/stdexcept.md)例外を送出する。
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <string_view>
+
+int main()
+{
+  const std::string_view sv = "hello";
+
+  // 全体をコピーする
+  {
+    char result[5 + 1] = {};
+    sv.copy(result, 5);
+
+    std::cout << result << std::endl;
+  }
+
+  // 先頭3要素だけコピーする
+  {
+    char result[3 + 1] = {};
+    sv.copy(result, 3);
+
+    std::cout << result << std::endl;
+  }
+
+  // 2番目以降の要素をコピーする
+  {
+    char result[3 + 1] = {};
+    sv.copy(result, 3, 2);
+
+    std::cout << result << std::endl;
+  }
+}
+```
+* copy[color ff0000]
+
+### 出力
+```
+hello
+hel
+llo
+```
+
+
+## バージョン
+### 言語
+- C++17
+
+### 処理系
+- [Clang, C++17 mode](/implementation.md#clang): 4.0
+- [GCC, C++17 mode](/implementation.md#gcc): 7.1
+- [ICC](/implementation.md#icc): ??
+- [Visual C++](/implementation.md#visual_cpp): ??