charconv : C++26対応としてfrom_chars_result / to_chars_resultにoperator boolを追加 (close #1179)

faithandbrave · faithandbrave · commit 923f1521f99a · 2024-01-25T13:32:02.000+09:00
diff --git a/reference/charconv/from_chars.md b/reference/charconv/from_chars.md
@@ -118,7 +118,7 @@ C++標準はこれら関数の実装の詳細について何も規定しない
 
 ## 例
 
-### 基本の使用例
+### 基本の使用例 (C++17)
 
 ```cpp example
 #include <iostream>
@@ -276,6 +276,164 @@ nan
 -inf
 ```
 
+### 基本の使用例 (C++26)
+```cpp example
+#include <iostream>
+#include <iomanip>
+#include <charconv>
+
+int main()
+{
+  {
+    const char str[] = "00000123456789 is decimal";
+    int value{};
+
+    //(1) 10進数文字列からintへ変換
+    //変換変換の成否判定に`operator bool`を使用
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "1111111111111111 is (65535)_10";
+    int value{};
+
+    //(1) 2進数文字列からintへ変換
+    if (std::from_chars(std::begin(str), std::end(str), value, 2)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "Z is (35)_10";
+    int value{};
+
+    //(1) 36進数文字列からintへ変換
+    if (std::from_chars(std::begin(str), std::end(str), value, 36)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "255";
+    char value{};
+
+    //(1) 失敗する例 MSVCにおけるcharの範囲は-128～127
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  std::cout << std::setprecision(16);
+
+  {
+    const char str[] = "3.1415926535897932384626433832795 is pi";
+    double value{};
+
+    //(3) 固定小数表記文字列からdoubleへ変換
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "1.10001e-01 is Liouville number";
+    double value{};
+
+    //(3) 指数表記文字列からdoubleへ変換
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "1.c29068986fcdf000p-4 is Liouville number";
+    double value{};
+
+    //(3) 16進指数表記文字列からdoubleへ変換
+    if (std::from_chars(std::begin(str), std::end(str), value, std::chars_format::hex)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = " 3.1415926535897932384626433832795 is pi";
+    double value{};
+
+    //(3) 失敗する例 ホワイトスペース読み飛ばし
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "NaN";
+    double value{};
+
+    //(3) NaNの読み取り
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+
+  {
+    const char str[] = "-INF";
+    double value{};
+
+    //(3) INFの読み取り
+    if (std::from_chars(std::begin(str), std::end(str), value)) {
+      std::cout << value << std::endl;
+    }
+    else {
+      std::cout << "conversion failed." << std::endl;
+    }
+  }
+}
+```
+
+#### 出力例
+```
+123456789
+65535
+35
+conversion failed.
+3.141592653589793
+0.110001
+0.110001
+conversion failed.
+nan
+-inf
+```
+
+
 ### イテレータ範囲からの変換（C++20）
 
 入力文字列はポインタによる範囲で指定する必要があるが、`std::string`等のイテレータは必ずしもポインタとは限らず、そのままでは使いづらいことがある。その様なとき、C++20の[`std::to_address`](/reference/memory/to_address.md)を使用すると安全かつ簡易にこの関数でイテレータを使用できる。
diff --git a/reference/charconv/from_chars_result.md b/reference/charconv/from_chars_result.md
@@ -25,6 +25,13 @@ namespace std {
 | ec | 成功なら`ec == errc{}`、失敗ならば`errc::invalid_argument`を表す[`errc`](/reference/system_error/errc.md)の値。 | C++17 |
 
 ## メンバ関数
+### 成否判定
+
+| 名前 | 説明 | 対応バージョン |
+|------|------|----------------|
+| [`operator bool`](from_chars_result/op_bool.md) | 変換に成功したかを判定する | C++26 |
+
+
 ### 比較演算子
 
 | 名前 | 説明 | 対応バージョン |
diff --git a/reference/charconv/from_chars_result/op_bool.md b/reference/charconv/from_chars_result/op_bool.md
@@ -0,0 +1,58 @@
+# operator bool
+* charconv[meta header]
+* std[meta namespace]
+* from_chars_result[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr explicit operator bool() const noexcept;
+```
+
+## 概要
+変換が成功したかを判定する。
+
+
+## 戻り値
+```cpp
+return ec == errc{};
+```
+* errc[link /reference/system_error/errc.md]
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <charconv>
+
+int main()
+{
+  const char str[] = "123";
+  int value{};
+  if (std::from_chars(std::begin(str), std::end(str), value)) {
+    std::cout << value << std::endl;
+  }
+  else {
+    std::cout << "conversion failed" << std::endl;
+  }
+}
+```
+* std::from_chars[link /reference/charconv/from_chars.md]
+
+### 出力
+```
+123
+```
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): ??
+- [GCC](/implementation.md#gcc): ??
+- [Visual C++](/implementation.md#visual_cpp): ??
+
+
+## 参照
+- [P2497R0 Testing for success or failure of `<charconv>` functions](https://open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2497r0.html)
diff --git a/reference/charconv/to_chars.md b/reference/charconv/to_chars.md
@@ -175,7 +175,7 @@ C++標準はこれら関数の実装の詳細について何も規定しない
 
 
 ## 例
-
+### 基本の使用例 (C++17)
 ```cpp example
 #include <iostream>
 #include <charconv>
@@ -268,7 +268,111 @@ int main()
 * std::chars_format[link chars_format.md]
 * std::errc[link /reference/system_error/errc.md]
 
-### 出力例（VS2019 16.5 preview 1）
+#### 出力例（VS2019 16.5 preview 1）
+```
+10
+1111111111111111
+z
+0.110001
+1.10001e-01
+0.110001
+1.c29068986fcdfp-4
+1.1000100000000000e-01
+0.1100010000000000
+1.c29068986fcdf000p-4
+```
+
+### 基本の使用例 (C++26)
+```cpp example
+#include <iostream>
+#include <charconv>
+
+int main()
+{
+  char out[50]{};
+  auto begin = std::begin(out);
+  auto end = std::end(out);
+
+  //(1) 10進数文字列へ変換
+  if (auto result = std::to_chars(begin, end, 10)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+  //(1) 2進数文字列へ変換
+  if (auto result = std::to_chars(begin, end, 65535, 2)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+  //(1) 36進数文字列へ変換
+  if (auto result = std::to_chars(begin, end, 35, 36)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+
+  //リウヴィル数 
+  constexpr double l = 0.11000100000000000000000100000000000;
+
+  //(3) 精度・フォーマット指定なしの浮動小数点数変換
+  if (auto result = std::to_chars(begin, end, l)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+
+  //(7) 精度指定なしの浮動小数点数変換、指数表記
+  if (auto result = std::to_chars(begin, end, l, std::chars_format::scientific)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+  //(7) 精度指定なしの浮動小数点数変換、固定小数表記
+  if (auto result = std::to_chars(begin, end, l, std::chars_format::fixed)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+  //(7) 精度指定なしの浮動小数点数変換、16進指数表記
+  if (auto result = std::to_chars(begin, end, l, std::chars_format::hex)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+
+  //(11) 精度指定ありの浮動小数点数変換、指数表記
+  if (auto result = std::to_chars(begin, end, l, std::chars_format::scientific, 16)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+  //(11) 精度指定ありの浮動小数点数変換、固定小数表記
+  if (auto result = std::to_chars(begin, end, l, std::chars_format::fixed, 16)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+  //(11) 精度指定ありの浮動小数点数変換、16進指数表記
+  if (auto result = std::to_chars(begin, end, l, std::chars_format::hex, 16)) {
+    std::cout << std::string_view(begin, result.ptr - begin) << std::endl;
+  }
+  else {
+    std::cout << "conversion failed." << std::endl;
+  }
+}
+```
+
+#### 出力例
 ```
 10
 1111111111111111
diff --git a/reference/charconv/to_chars_result.md b/reference/charconv/to_chars_result.md
@@ -24,6 +24,13 @@ namespace std {
 | ec | 成功なら`ec == errc{}`、失敗ならば`errc::value_too_large`を表す[`errc`](/reference/system_error/errc.md)の値。 | C++17 |
 
 ## メンバ関数
+### 成否判定
+
+| 名前 | 説明 | 対応バージョン |
+|------|------|----------------|
+| [`operator bool`](to_chars_result/op_bool.md) | 変換に成功したかを判定する | C++26 |
+
+
 ### 比較演算子
 
 | 名前 | 説明 | 対応バージョン |
diff --git a/reference/charconv/to_chars_result/op_bool.md b/reference/charconv/to_chars_result/op_bool.md
