add basic_string::subview() and basic_string_view::subview(). (#1503)

Author: suomesta

reference/string/basic_string.md

@@ -145,6 +145,7 @@ namespace std {
 | [`find_first_not_of`](basic_string/find_first_not_of.md)             | 先頭から、指定文字が見つからない位置を検索する |                |
 | [`find_last_not_of`](basic_string/find_last_not_of.md)               | 末尾から、指定文字が見つからない位置を検索する |                |
 | [`substr`](basic_string/substr.md)                                   | 部分文字列を取得する                           |                |
+| [`subview`](basic_string/subview.md)                                 | 部分文字列の[`std::basic_string_view`](/reference/string_view/basic_string_view.md)を構築する | C++26 |
 | [`compare`](basic_string/compare.md)                                 | 他の文字列との比較を行う                       |                |
 | [`starts_with`](basic_string/starts_with.md)                         | 指定の文字列で始まるかを判定する               | C++20          |
 | [`ends_with`](basic_string/ends_with.md)                             | 指定の文字列で終わるかを判定する               | C++20          |

reference/string/basic_string/subview.md

@@ -0,0 +1,90 @@
+# subview
+* string[meta header]
+* std[meta namespace]
+* basic_string[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr basic_string_view<charT, traits>
+  subview(size_type pos = 0,
+          size_type n = npos) const;
+```
+
+## 概要
+部分文字列の[`std::basic_string_view`](/reference/string_view/basic_string_view.md)を構築する。
+`pos`番目から`n`要素の[`std::basic_string_view`](/reference/string_view/basic_string_view.md)を返す。
+引数省略時は、先頭位置（`0`番目）から全要素（`npos`）の文字列を返す。
+
+
+## 要件
+`pos <=` [`size()`](size.md)
+
+
+## 効果
+次と等価 : `return` [`basic_string_view`](/reference/string_view/basic_string_view.md)`<charT, traits>(*this).`[`subview`](/reference/string_view/basic_string_view/subview.md)`(pos, n)`。
+
+
+## 注意
+本関数は使い方を誤ると、ぶら下がり参照が発生し得る。
+```cpp example
+#include <print>
+#include <string>
+#include <string_view>
+
+int main() {
+    // OK
+    std::string s(3, 'A');
+    std::string_view sv = s.subview();
+    std::println("{}", sv);
+
+    // OK
+    std::println("{}", std::string(3, 'A').subview());
+
+    // NG!
+    std::string_view d = std::string(3, 'A').subview();  // ぶら下がり参照発生
+    std::println("{}", d);  // 不定動作
+}
+```
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <string>
+#include <string_view>
+
+int main() {
+    std::string s = "Hello world!";
+
+    std::string_view sv = s.subview(6, 5);
+
+    std::cout << sv;
+}
+```
+* subview[color ff0000]
+
+### 出力
+```
+world
+```
+
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): ??
+- [GCC](/implementation.md#gcc): ??
+- [ICC](/implementation.md#icc): ??
+- [Visual C++](/implementation.md#visual_cpp): ??
+
+
+## 参照
+
+- [P3044R2 sub-string_view from string](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3044r2.pdf)
+
+
+## 関連項目
+- [`basic_string_view::subview`](/reference/string_view/basic_string_view/subview.md)

reference/string_view/basic_string_view.md

@@ -94,6 +94,7 @@ string_view hello = sv.substr(0, 5); // 先頭5文字を抽出する
 |------|------|----------------|
 | [`copy`](basic_string_view/copy.md)               | 他の文字列に、自身の文字列をコピーする         | C++17 |
 | [`substr`](basic_string_view/substr.md)           | 部分文字列を取得する                           | C++17 |
+| [`subview`](basic_string_view/subview.md)         | 部分文字列を取得する                           | C++26 |
 | [`compare`](basic_string_view/compare.md)         | 他の文字列との比較を行う                       | C++17 |
 | [`starts_with`](basic_string_view/starts_with.md) | 指定の文字列で始まるかを判定する               | C++20 |
 | [`ends_with`](basic_string_view/ends_with.md)     | 指定の文字列で終わるかを判定する               | C++20 |

reference/string_view/basic_string_view/substr.md

@@ -65,3 +65,7 @@ int main()
 - [GCC](/implementation.md#gcc): 7.1 [mark verified]
 - [ICC](/implementation.md#icc): ??
 - [Visual C++](/implementation.md#visual_cpp): ??
+
+
+## 関連項目
+- [`subview`](subview.md)

reference/string_view/basic_string_view/subview.md

@@ -0,0 +1,80 @@
+# subview
+* string_view[meta header]
+* std[meta namespace]
+* basic_string_view[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr basic_string_view<charT, traits>
+  subview(size_type pos = 0,
+          size_type n = npos) const;
+```
+
+## 概要
+部分文字列を取得する。
+
+本関数は[`substr`](substr.md)と全く同じ動作である。[`std::string`](/reference/string/basic_string.md)とインターフェースを揃える目的で追加された。
+
+
+## 戻り値
+指定された位置`pos`から`n`文字からなる部分文字列を構築して返す。
+
+[`size()`](size.md) `- pos`と`n`うち、小さい方を`rlen`とし、`basic_string_view(`[`data()`](data.md) `+ pos, rlen)`を返す。
+
+
+## 例外
+`pos >` [`size()`](size.md)の場合、[`std::out_of_range`](/reference/stdexcept.md)例外を送出する。
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <string_view>
+
+int main()
+{
+  std::string_view sv = "This is a pen";
+
+  std::string_view ret1 = sv.subview(5);    // 5番目から最後までの文字列を取得
+  std::string_view ret2 = sv.subview(5, 2); // 5番目から2文字の文字列を取得
+
+  std::cout << "1 : [" << ret1 << ']' << std::endl;
+  std::cout << "2 : [" << ret2 << ']' << std::endl;
+
+  // subviewはデータを切り取るのではなく、参照位置と参照サイズを変更するだけなので、
+  // 生ポインタを介せば全体の文字列を復元することはできる。
+  const char* ret3 = ret1.data() - 5;
+  std::cout << "3 : [" << ret3 << ']' << std::endl;
+}
+```
+* subview[color ff0000]
+* ret1.data()[link data.md]
+
+### 出力
+```
+1 : [is a pen]
+2 : [is]
+3 : [This is a pen]
+```
+
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): ??
+- [GCC](/implementation.md#gcc): ??
+- [ICC](/implementation.md#icc): ??
+- [Visual C++](/implementation.md#visual_cpp): ??
+
+
+## 参照
+
+- [P3044R2 sub-string_view from string](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3044r2.pdf)
+
+
+## 関連項目
+- [`substr`](substr.md)
+- [`basic_string::subview`](/reference/string/basic_string/subview.md)