basic_stringbuf : C++26 string_viewに対応 #1186

Author: faithandbrave

reference/sstream/basic_stringbuf/op_constructor.md

@@ -56,25 +56,67 @@ basic_stringbuf(
 
 basic_stringbuf(basic_stringbuf&& rhs);                       // (11) C++11
 basic_stringbuf(basic_stringbuf&& rhs, const Allocator& a);   // (12) C++20
+
+template<class T>
+explicit
+basic_stringbuf(
+  const T& t,
+  ios_base::openmode which = ios_base::in | ios_base::out);   // (13) C++26
+
+template<class T>
+basic_stringbuf(
+  const T& t,
+  const Allocator& a);                                        // (14) C++26
+
+template<class T>
+basic_stringbuf(
+  const T& t,
+  ios_base::openmode which,
+  const Allocator& a);                                        // (15) C++26
 ```
 * ios_base[link /reference/ios/ios_base.md]
 * basic_string[link /reference/string/basic_string.md]
 
 ## 概要
 `basic_stringbuf`オブジェクトを構築する。
 
+- (1) : デフォルトコンストラクタ
+- (2) : 指定されたモードで構築する
+- (3) : [`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、指定されたモードで構築する
+- (4) : モードとアロケータを指定して構築する
+- (5) : アロケータを指定して構築する
+- (6) : [`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、アロケータを指定して構築する
+- (7) : [`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピー、モード、アロケータを指定して構築する
+- (8) : `Allocator`に変換可能なアロケータ型をもつ`std::basic_string`オブジェクトのコピーと、指定されたモードで構築する
+- (9) : `Allocator`に変換可能なアロケータ型をもつ`std::basic_string`オブジェクトのコピーと、アロケータを指定して構築する
+- (10) : `Allocator`に変換可能なアロケータ型をもつ`std::basic_string`オブジェクトのコピー、モード、アロケータを指定して構築する
+- (11) : ムーブコンストラクタ
+- (12) : ムーブコンストラクタでアロケータを指定して構築する
+- (13) : [`basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列を初期化し、モードを設定する
+- (14) : [`basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列を初期化、アロケータを設定する
+- (15) : [`basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列を初期化し、モードとアロケータを設定する
+
+
+## テンプレートパラメータ制約
+- (13), (14), (15) : `is_convertible_v<const T&, basic_string_view<CharT, Traits>>`が`true`であること
+
+
 ## 効果
 - (1) : 内部の文字列バッファを空にし、モードは`ios_base::in | ios_base::out`に設定する
 - (2) : 内部の文字列バッファを空にし、モードは`which`に設定する
 - (3) : 内部の文字列バッファを`s`のコピー、モードは`which`に設定する
 - (4) : 内部の文字列バッファを`std::move(s)`で、モードは`which`に設定する
 - (5) : 内部の文字列バッファを空にし、モードは`which`、アロケータは`a`に設定する
-- (6), (7), (8), (9), (10), (11) : 各引数は内部状態の初期化に使用される
-- (12) : `rhs`から`basic_stringbuf`オブジェクトをムーブ構築する
-- (13) : `rhs`から`basic_stringbuf`オブジェクトをムーブ構築し、アロケータは`a`を使用する
+- (6), (7), (8), (9), (10) : 各引数は内部状態の初期化に使用される
+- (11) : `rhs`から`basic_stringbuf`オブジェクトをムーブ構築する
+- (12) : `rhs`から`basic_stringbuf`オブジェクトをムーブ構築し、アロケータは`a`を使用する
+- (13) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`which`に設定する
+- (14) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`ios_base::in | ios_base::out`、アロケータは`a`に設定する
+- (15) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`which`、アロケータは`a`に設定する
 
 
 ## 例
+### 基本的な使い方
 ```cpp example
 #include <iostream>
 #include <sstream>
@@ -95,11 +137,37 @@ int main()
 * sputc[link /reference/streambuf/basic_streambuf/sputc.md]
 * str()[link str.md]
 
-### 出力
+#### 出力
 ```
 a
 initial!
 ```
 
+#### string_viewからの構築 (C++26)
+```cpp example
+#include <print>
+#include <sstream>
+#include <string_view>
+
+int main()
+{
+  std::string_view sv = "from string literal";
+  std::stringbuf buf1{sv};
+  std::println("{}", buf1.str());
+
+  std::string_view sv2 = "from string_view";
+  std::stringbuf buf2{sv2};
+  std::println("{}", buf2.str());
+}
+```
+
+#### 出力
+```
+from string literal
+from string_view
+```
+
 ## 参照
-- [P0408R7 Efficient Access to `basic_stringbuf`'s Buffer](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0408r7.pdf)
+- [P0408R7 Efficient Access to `basic_stringbuf`'s Buffer](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0408r7.pdf)
+- [P2495R3 Interfacing stringstreams with `string_view`](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2495r3.pdf)
+    - C++26で[`std::string_view`](/reference/string_view/basic_string_view.md)に対応した

reference/sstream/basic_stringbuf/str.md

@@ -19,21 +19,40 @@ template <class SAlloc>
 void str(const basic_string<CharT, Traits, SAlloc>& s);     // (5) C++20
 
 void str(const basic_string<CharT, Traits, Allocator>&& s); // (6) C++20
+
+template<class T>
+void str(const T& t);                                       // (7) C++26
 ```
 * basic_string[link /reference/string/basic_string.md]
 
 ## 概要
 文字列オブジェクトを取得または設定する。
 
+- (1) : 文字列オブジェクトを取得する
+- (2) : 文字列オブジェクトを取得し、`SAlloc`型のアロケータ`sa`によってメモリ確保する
+- (3) : 保持する文字列オブジェクトをムーブして取得する
+- (4) : 文字列オブジェクト`s`を設定する
+- (5) : `Allocator`に変換可能な`SAlloc`型のアロケータによって確保されているデータをコピーして、文字列オブジェクト`s`を設定する
+- (6) : 与えられた文字列オブジェクト`s`をムーブして設定する
+- (7) : [`basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列を設定する
+
+
+## テンプレートパラメータ制約
+- (7) : `is_convertible_v<const T&, basic_string_view<CharT, Traits>>`が`true`であること
+
+
 ## 効果
 - (1) : 文字列オブジェクトを取得する
 - (2) : 文字列オブジェクトを取得して、`SAlloc`型のアロケータ`sa`によって確保する
 - (3) : 保持する文字列オブジェクトをムーブして取得する
 - (4) : 文字列オブジェクト`s`を設定する
-- (5) : `SAlloc`型のアロケータによって確保されているデータをコピーして、文字列オブジェクト`s`を設定する
+- (5) : `Allocator`に変換可能な`SAlloc`型のアロケータによって確保されているデータをコピーして、文字列オブジェクト`s`を設定する
 - (6) : 与えられた文字列オブジェクト`s`をムーブして設定する
+- (7) : [`basic_string_view`](/reference/string_view/basic_string_view.md)`<CharT, Traits>(t)`から文字列を設定する
+
 
 ## 例
+### 基本的な使い方
 ```cpp example
 #include <iostream>
 #include <sstream>
@@ -64,26 +83,82 @@ int main()
   buf.sputc('Y');
   std::cout << "4: After writing: " << buf.str() << std::endl;
   
-  // C++20: ムーブによる設定
-  std::string s = "Move test";
-  buf.str(std::move(s));
-  std::cout << "5: " << buf.str() << std::endl;
+  // C++26: string_viewから設定
+  // std::string_view sv = "string_view test";
+  // buf.str(sv);
+  // std::cout << "6: " << buf.str() << std::endl;
   
   // 空文字列でクリア
   buf.str("");
-  std::cout << "6: Empty? " << (buf.str().empty() ? "yes" : "no") << std::endl;
+  std::cout << "7: Empty? " << (buf.str().empty() ? "yes" : "no") << std::endl;
 }
 ```
 * sputn[link /reference/streambuf/basic_streambuf/sputn.md]
 * sbumpc[link /reference/streambuf/basic_streambuf/sbumpc.md]
 * sputc[link /reference/streambuf/basic_streambuf/sputc.md]
 
-### 出力
+#### 出力
 ```
 1: Hello, World!
 2: New content
 3: After reading 2 chars: Read/Write test
 4: After writing: ReXY/Write test
 5: Move test
-6: Empty? yes
+7: Empty? yes
 ```
+
+#### ムーブを使用する例 (C++20)
+```cpp example
+#include <iostream>
+#include <sstream>
+
+int main() {
+  std::stringbuf buf;
+
+  // ムーブして文字列を設定
+  std::string s = "Move string";
+  buf.str(std::move(s));
+  std::cout << buf.str() << std::endl;
+
+  // ムーブで文字列を取得
+  std::string r = std::move(buf).str();
+  std::cout << r << std::endl;
+}
+```
+
+#### 出力
+```
+Move string
+Move string
+```
+
+### string_viewからの設定 (C++26)
+```cpp example
+#include <iostream>
+#include <sstream>
+#include <string_view>
+
+int main() {
+  std::stringbuf buf;
+
+  // 文字列リテラルを設定
+  buf.str("set from string literal");
+  std::cout << buf.str() << std::endl;
+
+  // string_viewを設定
+  std::string_view sv = "set from string_view";
+  buf.str(sv);
+  std::cout << buf.str() << std::endl;
+}
+```
+
+#### 出力
+```
+set from string literal
+set from string_view
+```
+
+## 参照
+- [P0408R7 Efficient Access to `basic_stringbuf`'s Buffer](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0408r7.pdf)
+- [P2495R3 Interfacing stringstreams with `string_view`](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2495r3.pdf)
+    - C++26で[`std::string_view`](/reference/string_view/basic_string_view.md)に対応した