[i|o]stringstream : C++26 string_viewの仕様に対応 #1186

Author: faithandbrave

reference/sstream/basic_istringstream/op_constructor.md

@@ -52,24 +52,62 @@ basic_istringstream(
   const Allocator& a);                               // (9) C++20
 
 basic_istringstream(basic_istringstream&& rhs);      // (10) C++11
+
+template<class T>
+explicit basic_istringstream(
+  const T& t,
+  ios_base::openmode which = ios_base::in);          // (11) C++26
+
+template<class T>
+basic_istringstream(
+  const T& t,
+  const Allocator& a);                               // (12) C++26
+
+template<class T>
+basic_istringstream(
+  const T& t,
+  ios_base::openmode which,
+  const Allocator& a);                               // (13) C++26
 ```
 * ios_base[link /reference/ios/ios_base.md]
 * basic_string[link /reference/string/basic_string.md]
 
 ## 概要
 `basic_istringstream`オブジェクトを構築する。
 
+- (1) : デフォルトコンストラクタ
+- (2) : 指定されたモードで構築する
+- (3) : 入力文字列として[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーを指定して構築する
+- (4) : 指定されたモードとアロケータで構築する
+- (5) : 入力文字列として[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、アロケータを指定して構築する
+- (6) : 入力文字列として[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピー、モード、アロケータを指定して構築する
+- (7) : 入力文字列として`Allocator`に変換可能なアロケータをもつ[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、モードを指定して構築する
+- (8) : 入力文字列として`Allocator`に変換可能なアロケータをもつ[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、アロケータを指定して構築する
+- (9) : 入力文字列として`Allocator`に変換可能なアロケータをもつ[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピー、モード、アロケータを指定して構築する
+- (10) : ムーブコンストラクタ
+- (11) : 入力文字列として[`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列と、モードを指定して構築する
+- (12) : 入力文字列として[`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列と、アロケータを指定して構築する
+- (13) : 入力文字列として[`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列、モード、アロケータを指定して構築する
+
+
+## テンプレートパラメータ制約
+- (11), (12), (13) : `is_convertible_v<const T&, basic_string_view<CharT, Traits>>`が`true`であること
+
 ## 効果
 - (1) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(ios_base::in)`で構築する
 - (2) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(which | ios_base::in)`で構築する
 - (3) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(s, which | ios_base::in)`で構築する
 - (4) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(std::move(s), which | ios_base::in)`で構築する
 - (5) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(which | ios_base::in, a)`で構築する
-- (6), (7), (8), (9), (10) : 各引数が対応する`basic_stringbuf`のコンストラクタに渡される
-- (11) : `rhs`から`basic_istringstream`オブジェクトをムーブ構築する
+- (6), (7), (8), (9) : 各引数が対応する`basic_stringbuf`のコンストラクタに渡される
+- (10) : `rhs`から`basic_istringstream`オブジェクトをムーブ構築する
+- (11) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`which | ios_base::in`に設定する
+- (12) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`ios_base::in`、アロケータは`a`に設定する
+- (13) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`which | ios_base::in`、アロケータは`a`に設定する
 
 
 ## 例
+### 基本的な使い方
 ```cpp example
 #include <iostream>
 #include <sstream>
@@ -82,16 +120,48 @@ int main()
   // (3) 文字列を指定して構築
   std::istringstream ss2("initial text");
   
-  int value;
+  std::string value;
   ss2 >> value;
   std::cout << value << std::endl;
 }
 ```
 
-### 出力
+#### 出力
 ```
 initial
 ```
 
+### string_viewからの構築 (C++26)
+```cpp example
+#include <iostream>
+#include <sstream>
+#include <string_view>
+
+int main()
+{
+  // 文字列リテラルから構築
+  std::istringstream ss1{"Hello World"};
+  std::string s1;
+  ss1 >> s1;
+  std::cout << s1 << std::endl;
+
+  // string_viewから構築
+  std::string_view sv = "Hello World";
+  std::istringstream ss2{sv};
+  std::string s2;
+  ss2 >> s2;
+  std::cout << s2 << std::endl;
+}
+```
+
+#### 出力
+```
+Hello
+Hello
+```
+
+
 ## 参照
-- [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_istringstream/str.md

@@ -18,21 +18,38 @@ void str(const basic_string<CharT, Traits, Allocator>& s);  // (4) C++03
 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) : [`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列を設定する
+
+
+## テンプレートパラメータ制約
+- (7) : `is_convertible_v<const T&, basic_string_view<CharT, Traits>>`が`true`であること
+
 ## 効果
 - (1) : `return rdbuf()->str()` と等価
 - (2) : `return rdbuf()->str(sa)` と等価
 - (3) : `return std::move(*rdbuf()).str()` と等価
 - (4) : `rdbuf()->str(s)` と等価
 - (5) : `rdbuf()->str(s)` と等価
 - (6) : `rdbuf()->str(std::move(s))` と等価
+- (7) : `rdbuf()->str(t)` と等価
 
 ## 例
+### 基本的な使い方
 ```cpp example
 #include <iostream>
 #include <sstream>
@@ -66,7 +83,7 @@ int main()
 }
 ```
 
-### 出力
+#### 出力
 ```
 Content: Hello World 123 45.67
 Read word: Hello
@@ -75,9 +92,64 @@ New read: New content 999
 Empty? yes
 ```
 
+#### ムーブを使用する例 (C++20)
+```cpp example
+#include <iostream>
+#include <sstream>
+
+int main() {
+  std::istringstream ss;
+
+  // ムーブして文字列を設定
+  std::string s = "Move string";
+  ss.str(std::move(s));
+  std::cout << ss.str() << std::endl;
+
+  // ムーブで文字列を取得
+  std::string r = std::move(ss).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::istringstream ss;
+
+  // 文字列リテラルを設定
+  ss.str("set from string literal");
+  std::cout << ss.str() << std::endl;
+
+  // string_viewを設定
+  std::string_view sv = "set from string_view";
+  ss.str(sv);
+  std::cout << ss.str() << std::endl;
+}
+```
+
+#### 出力
+```
+set from string literal
+set from string_view
+```
+
+
 ## 関連項目
 - [`basic_stringbuf::str`](../basic_stringbuf/str.md)
 
 
 ## 参照
 - [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_ostringstream/op_constructor.md

@@ -52,24 +52,64 @@ basic_ostringstream(
   const Allocator& a);                               // (9) C++20
 
 basic_ostringstream(basic_ostringstream&& rhs);      // (10) C++11
+
+template<class T>
+explicit basic_ostringstream(
+  const T& t,
+  ios_base::openmode which = ios_base::out);         // (11) C++26
+
+template<class T>
+basic_ostringstream(
+  const T& t,
+  const Allocator& a);                               // (12) C++26
+
+template<class T>
+basic_ostringstream(
+  const T& t,
+  ios_base::openmode which,
+  const Allocator& a);                               // (13) C++26
 ```
 * ios_base[link /reference/ios/ios_base.md]
 * basic_string[link /reference/string/basic_string.md]
 
 ## 概要
 `basic_ostringstream`オブジェクトを構築する。
 
+ここで、初期値として設定する文字列は、既存のファイルを上書きモードで開くことに似ており、ストリームの初期位置が先頭のまま、ストリーム内容の文字列を設定するものである。モードとして[`std::ios_base::ate`](/reference/ios/ios_base/type-openmode.md)を指定しすると、ストリームの初期位置が末尾に設定される。
+
+- (1) : デフォルトコンストラクタ
+- (2) : 指定されたモードで構築する
+- (3) : 初期文字列として[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーを指定して構築する
+- (4) : 指定されたモードとアロケータで構築する
+- (5) : 初期文字列として[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、アロケータを指定して構築する
+- (6) : 初期文字列として[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピー、モード、アロケータを指定して構築する
+- (7) : 初期文字列として`Allocator`に変換可能なアロケータをもつ[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、モードを指定して構築する
+- (8) : 初期文字列として`Allocator`に変換可能なアロケータをもつ[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピーと、アロケータを指定して構築する
+- (9) : 初期文字列として`Allocator`に変換可能なアロケータをもつ[`std::basic_string`](/reference/string/basic_string.md)オブジェクトのコピー、モード、アロケータを指定して構築する
+- (10) : ムーブコンストラクタ
+- (11) : 初期文字列として[`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列と、モードを指定して構築する
+- (12) : 初期文字列として[`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列と、アロケータを指定して構築する
+- (13) : 初期文字列として[`std::basic_string_view`](/reference/string_view/basic_string_view.md)に変換可能な文字列、モード、アロケータを指定して構築する
+
+
+## テンプレートパラメータ制約
+- (11), (12), (13) : `is_convertible_v<const T&, basic_string_view<CharT, Traits>>`が`true`であること
+
 ## 効果
 - (1) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(ios_base::out)`で構築する
 - (2) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(which | ios_base::out)`で構築する
 - (3) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(s, which | ios_base::out)`で構築する
 - (4) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(std::move(s), which | ios_base::out)`で構築する
 - (5) : 内部の`basic_stringbuf`オブジェクトを`basic_stringbuf<CharT, Traits, Allocator>(which | ios_base::out, a)`で構築する
-- (6), (7), (8), (9), (10) : 各引数が対応する`basic_stringbuf`のコンストラクタに渡される
-- (11) : `rhs`から`basic_ostringstream`オブジェクトをムーブ構築する
+- (6), (7), (8), (9) : 各引数が対応する`basic_stringbuf`のコンストラクタに渡される
+- (10) : `rhs`から`basic_ostringstream`オブジェクトをムーブ構築する
+- (11) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`which | ios_base::out`に設定する
+- (12) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`ios_base::out`、アロケータは`a`に設定する
+- (13) : `basic_string_view<CharT, Traits>(t)`で文字列を初期化し、モードは`which | ios_base::out`、アロケータは`a`に設定する
 
 
 ## 例
+### 基本的な使い方
 ```cpp example
 #include <iostream>
 #include <sstream>
@@ -82,18 +122,47 @@ int main()
   std::cout << ss1.str() << std::endl;
   
   // (3) 文字列を指定して構築
-  std::ostringstream ss2("initial ");
+  std::ostringstream ss2("xxxx yyyy");
   ss2 << "text";
   std::cout << ss2.str() << std::endl;
 }
 ```
 * str()[link str.md]
 
-### 出力
+#### 出力
 ```
 default
-initial text
+text yyyy
+```
+
+### string_viewからの構築 (C++26)
+```cpp example
+#include <iostream>
+#include <sstream>
+#include <string_view>
+
+int main()
+{
+  // 文字列リテラルから構築
+  std::ostringstream ss1{"Hello?", std::ios_base::ate};
+  ss1 << "World";
+  std::cout << ss1.str() << std::endl;
+
+  // string_viewから構築
+  std::string_view sv = "Hello?";
+  std::ostringstream ss2{sv};
+  ss2 << "World";
+  std::cout << ss2.str() << std::endl;
+}
+```
+
+#### 出力
+```
+Hello?World
+World?
 ```
 
 ## 参照
-- [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)に対応した