path : C++26対応として表示関係の文字列取得関数を追加 (close #1517)

Author: faithandbrave

lang/cpp26.md

@@ -297,10 +297,10 @@ C++26とは、2026年中に改訂される予定の、C++バージョンの通
     - `native_handle()`
 - [`std::filesystem::path`](/reference/filesystem/path.md)クラスに、文字列フォーマットのサポートを追加
 - [`std::filesystem::path`](/reference/filesystem/path.md)クラスに、出力用の文字列を取得するための、以下のメンバ関数を追加
-    - [`display_string()`](/reference/filesystem/path/display_string.md.nolink)
-    - [`system_encoded_string()`](/reference/filesystem/path/system_encoded_string.md.nolink)
-    - [`generic_display_string()`](/reference/filesystem/path/generic_display_string.md.nolink)
-    - [`generic_system_encoded_string()`](/reference/filesystem/path/generic_system_encoded_string.md.nolink)
+    - [`display_string()`](/reference/filesystem/path/display_string.md)
+    - [`system_encoded_string()`](/reference/filesystem/path/system_encoded_string.md)
+    - [`generic_display_string()`](/reference/filesystem/path/generic_display_string.md)
+    - [`generic_system_encoded_string()`](/reference/filesystem/path/generic_system_encoded_string.md)
 
 
 ### 入出力
@@ -543,9 +543,12 @@ C++26とは、2026年中に改訂される予定の、C++バージョンの通
 - [`<type_traits>`](/reference/type_traits.md)の[`std::is_trivial`](/reference/type_traits/is_trivial.md)を非推奨化
     - これは[`std::is_trivially_copyable`](/reference/type_traits/is_trivially_copyable.md)と[`std::is_trivially_default_constructible`](/reference/type_traits/is_trivially_default_constructible.md)の2つが合わさったものであるが、それらは異なる状況で必要になるものであった
 - [`std::memory_order::consume`](/reference/atomic/memory_order.md)と、それに関連して[`std::kill_dependency()`](/reference/atomic/kill_dependency.md)を非推奨化し、[`[[carries_dependency]]`](/lang/cpp11/attributes.md)属性を削除
-- [`std::filesystem::path`](/reference/filesystem/path.md)クラスの以下のメンバ関数を非推奨化
+- [`std::filesystem::path`](/reference/filesystem/path.md)クラスの、以下の非テンプレート版メンバ関数を非推奨化
     - [`string()`](/reference/filesystem/path/string.md)
     - [`generic_string()`](/reference/filesystem/path/generic_string.md)
+    - これらはOS依存のパス名エンコーディングへ変換するため、[iostream](/reference/iostream.md)・[`std::format()`](/reference/format/format.md)・[`std::print()`](/reference/print/print.md)を含むほぼすべての標準のテキスト処理・入出力機能と互換性がなく、文字化けやデータ損失の原因になりやすい
+    - レガシーなシステムAPIにパスを渡す用途では、システム依存エンコーディングへの変換であることを明確にした[`system_encoded_string()`](/reference/filesystem/path/system_encoded_string.md)・[`generic_system_encoded_string()`](/reference/filesystem/path/generic_system_encoded_string.md)を使用する
+    - 表示・フォーマットの用途では、[`display_string()`](/reference/filesystem/path/display_string.md)・[`generic_display_string()`](/reference/filesystem/path/generic_display_string.md)、もしくは[`std::format()`](/reference/format/format.md)・[`std::print()`](/reference/print/print.md)を使用する
 
 
 ### 非推奨の取り消し

reference/filesystem/path.md

@@ -60,7 +60,9 @@ namespace std::filesystem {
 | [`native`](path/native.md) | システムの文字コードとしてパス文字列を取得する | C++17 |
 | [`c_str`](path/c_str.md) | システムの文字コードとしてC言語の文字列表現を取得する | C++17 |
 | [`operator string_type`](path/op_string_type.md) | システムの文字コードとして文字列型に変換する | C++17 |
-| [`string`](path/string.md) | システムのマルチバイト文字コードとしてパス文字列を取得する | C++17 |
+| [`string`](path/string.md) | システムのマルチバイト文字コードとしてパス文字列を取得する | C++17<br/> 非テンプレート版はC++26で非推奨 |
+| [`display_string`](path/display_string.md) | 表示用のリテラルエンコーディングとしてパス文字列を取得する | C++26 |
+| [`system_encoded_string`](path/system_encoded_string.md) | システム依存エンコーディングとしてパス文字列を取得する | C++26 |
 | [`wstring`](path/wstring.md) | システムのワイド文字コードとしてパス文字列を取得する | C++17 |
 | [`u8string`](path/u8string.md) | UTF-8エンコードとしてパス文字列を取得する | C++17 |
 | [`u16string`](path/u16string.md) | UTF-16エンコードでパス文字列を取得する | C++17 |
@@ -70,7 +72,9 @@ namespace std::filesystem {
 
 | 名前 | 説明 | 対応バージョン |
 |------|------|----------------|
-| [`generic_string`](path/generic_string.md) | システムのマルチバイト文字コードとして、環境非依存パスフォーマットのパス文字列を取得する | C++17 |
+| [`generic_string`](path/generic_string.md) | システムのマルチバイト文字コードとして、環境非依存パスフォーマットのパス文字列を取得する | C++17<br/> 非テンプレート版はC++26で非推奨 |
+| [`generic_display_string`](path/generic_display_string.md) | 表示用のリテラルエンコーディングとして、環境非依存パスフォーマットのパス文字列を取得する | C++26 |
+| [`generic_system_encoded_string`](path/generic_system_encoded_string.md) | システム依存エンコーディングとして、環境非依存パスフォーマットのパス文字列を取得する | C++26 |
 | [`generic_wstring`](path/generic_wstring.md) | システムのワイド文字コードとして、環境非依存パスフォーマットのパス文字列を取得する | C++17 |
 | [`generic_u8string`](path/generic_u8string.md) | UTF-8エンコードで、環境非依存パスフォーマットのパス文字列を取得する | C++17 |
 | [`generic_u16string`](path/generic_u16string.md) | UTF-16エンコードで、環境非依存パスフォーマットのパス文字列を取得する | C++17 |

reference/filesystem/path/display_string.md

@@ -0,0 +1,74 @@
+# display_string
+* filesystem[meta header]
+* std::filesystem[meta namespace]
+* path[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+std::string display_string() const;
+```
+
+## 概要
+表示に適したリテラルエンコーディングで、パス文字列を取得する。
+
+[`std::format()`](/reference/format/format.md)や[`std::print()`](/reference/print/print.md)で出力するのに適した文字列を返す。
+
+
+## 戻り値
+以下と等価である：
+
+```cpp
+return std::format("{}", *this);
+```
+* std::format[link /reference/format/format.md]
+
+
+## 備考
+- 戻り値の文字列は、フォーマット ([`std::format()`](/reference/format/format.md)) や出力 ([`std::print()`](/reference/print/print.md)) で使用するのに適している
+- リテラルエンコーディングがUTF-8であり、パスが妥当なUnicodeであれば (Windowsのほとんどのパスがそうである)、文字コード変換は無損失となる
+
+
+## 例
+```cpp example
+#include <print>
+#include <filesystem>
+
+namespace fs = std::filesystem;
+
+int main()
+{
+  fs::path p = "/usr/bin/clang";
+
+  std::string s = p.display_string();
+  std::print("{}\n", s);
+}
+```
+* p.display_string()[color ff0000]
+
+### 出力
+```
+/usr/bin/clang
+```
+
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): 22 [mark noimpl]
+- [GCC](/implementation.md#gcc): 16.1 [mark noimpl]
+- [Visual C++](/implementation.md#visual_cpp): 2026 Update 2 [mark noimpl]
+
+
+## 関連項目
+- [`string()`](string.md) (システムのマルチバイト文字コードで取得する。C++26で非推奨)
+- [`system_encoded_string()`](system_encoded_string.md) (システム依存エンコーディングで取得する)
+- [`generic_display_string()`](generic_display_string.md) (環境非依存フォーマットで取得する)
+- [`formatter`](formatter.md) ([`std::format()`](/reference/format/format.md)での書式)
+
+
+## 参照
+- [P2319R5 Prevent path presentation problems](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p2319r5.html)
+    - 表示用のリテラルエンコーディングで文字列を取得するこの関数がC++26で追加された

reference/filesystem/path/generic_display_string.md

@@ -0,0 +1,74 @@
+# generic_display_string
+* filesystem[meta header]
+* std::filesystem[meta namespace]
+* path[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+std::string generic_display_string() const;
+```
+
+## 概要
+表示に適したリテラルエンコーディングで、環境非依存パスフォーマットのパス文字列を取得する。
+
+[`std::format()`](/reference/format/format.md)や[`std::print()`](/reference/print/print.md)で出力するのに適した文字列を返す。
+
+
+## 戻り値
+以下と等価である：
+
+```cpp
+return std::format("{:g}", *this);
+```
+* std::format[link /reference/format/format.md]
+
+
+## 備考
+- 戻り値の文字列は、フォーマット ([`std::format()`](/reference/format/format.md)) や出力 ([`std::print()`](/reference/print/print.md)) で使用するのに適している
+- リテラルエンコーディングがUTF-8であり、パスが妥当なUnicodeであれば (Windowsのほとんどのパスがそうである)、文字コード変換は無損失となる
+
+
+## 例
+```cpp example
+#include <print>
+#include <filesystem>
+
+namespace fs = std::filesystem;
+
+int main()
+{
+  fs::path p = "foo\\bar"; // ネイティブフォーマットのパス (ディレクトリ区切り文字がバックスラッシュ)
+
+  std::string s = p.generic_display_string();
+  std::print("{}\n", s);
+}
+```
+* p.generic_display_string()[color ff0000]
+
+### 出力
+```
+foo/bar
+```
+
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): 22 [mark noimpl]
+- [GCC](/implementation.md#gcc): 16.1 [mark noimpl]
+- [Visual C++](/implementation.md#visual_cpp): 2026 Update 2 [mark noimpl]
+
+
+## 関連項目
+- [`generic_string()`](generic_string.md) (システムのマルチバイト文字コードで取得する。C++26で非推奨)
+- [`generic_system_encoded_string()`](generic_system_encoded_string.md) (システム依存エンコーディングで取得する)
+- [`display_string()`](display_string.md) (システムフォーマットで取得する)
+- [`formatter`](formatter.md) ([`std::format()`](/reference/format/format.md)での書式)
+
+
+## 参照
+- [P2319R5 Prevent path presentation problems](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p2319r5.html)
+    - 表示用のリテラルエンコーディングで環境非依存フォーマットの文字列を取得するこの関数がC++26で追加された

reference/filesystem/path/generic_string.md

@@ -4,6 +4,7 @@
 * path[meta class]
 * function[meta id-type]
 * cpp17[meta cpp]
+* cpp26deprecated[meta cpp]
 
 ```cpp
 template <class EcharT,
@@ -15,6 +16,9 @@ std::basic_string<EcharT, traits, Allocator>
 std::string generic_string() const;                       // (2)
 ```
 
+(2)は、C++26で非推奨となった。システム依存エンコーディングへの変換であることを明確にした[`generic_system_encoded_string()`](generic_system_encoded_string.md)、もしくは表示に適した[`generic_display_string()`](generic_display_string.md)を使用すること。
+
+
 ## 概要
 - (1) : 指定された文字型に対応する文字コードで、環境非依存パスフォーマットのパス文字列を取得する
 - (2) : システムのマルチバイト文字コードで、環境非依存パスフォーマットのパス文字列を取得する
@@ -37,6 +41,15 @@ std::string generic_string() const;                       // (2)
     - POSIXベースシステムではUTF-8、Windowsの日本語環境ではCP932文字コードとなる
 
 
+## 非推奨の詳細 (C++26)
+(2)が返すシステム依存のパス名エンコーディングは、[iostream](/reference/iostream.md)・[`std::format()`](/reference/format/format.md)・[`std::print()`](/reference/print/print.md)を含むほぼすべての標準のテキスト処理・入出力機能と互換性がなく、文字化けやデータ損失の原因になりやすい。C++26ではこの問題を避けるために(2)が非推奨となり、用途に応じて以下の代替関数が追加された：
+
+- レガシーなシステムAPIにパスを渡す場合 : [`generic_system_encoded_string()`](generic_system_encoded_string.md) ((2)と同じ動作)
+- 表示・フォーマットする場合 : [`generic_display_string()`](generic_display_string.md)、[`std::format()`](/reference/format/format.md)、[`std::print()`](/reference/print/print.md)
+
+なお、テンプレート版である(1)は非推奨となっていない。
+
+
 ## 例
 ### POSIXベースシステムでの例
 ```cpp example
@@ -121,3 +134,13 @@ foo/bar
 - [Clang](/implementation.md#clang):
 - [GCC](/implementation.md#gcc): 8.1 [mark verified]
 - [Visual C++](/implementation.md#visual_cpp): 2017 Update 7 [mark verified]
+
+
+## 関連項目
+- [`generic_system_encoded_string()`](generic_system_encoded_string.md) (システム依存エンコーディングで取得する。(2)の代替)
+- [`generic_display_string()`](generic_display_string.md) (表示用のリテラルエンコーディングで取得する)
+
+
+## 参照
+- [P2319R5 Prevent path presentation problems](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p2319r5.html)
+    - 非テンプレート版の(2)がC++26で非推奨となり、[`generic_system_encoded_string()`](generic_system_encoded_string.md)・[`generic_display_string()`](generic_display_string.md)が代替として追加された

reference/filesystem/path/generic_system_encoded_string.md

@@ -0,0 +1,68 @@
+# generic_system_encoded_string
+* filesystem[meta header]
+* std::filesystem[meta namespace]
+* path[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+std::string generic_system_encoded_string() const;
+```
+
+## 概要
+OS依存のパス名エンコーディング (システムのマルチバイト文字コード) で、環境非依存パスフォーマットのパス文字列を取得する。
+
+
+## 戻り値
+環境非依存フォーマットのパス文字列を返す。
+
+文字コード変換が必要な場合、その変換は[`<filesystem>`](/reference/filesystem.md)のパス変換規則に従って行われる。
+
+
+## 備考
+- 文字コード変換は損失をともなう可能性があるため、この関数で取得した文字列はレガシーなシステムAPIにパスを渡す用途にのみ適している
+- 表示やフォーマットの用途では、[`generic_display_string()`](generic_display_string.md)、[`std::format()`](/reference/format/format.md)、[`std::print()`](/reference/print/print.md)を使用すること
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <filesystem>
+
+namespace fs = std::filesystem;
+
+int main()
+{
+  fs::path p = "foo\\bar"; // ネイティブフォーマットのパス (ディレクトリ区切り文字がバックスラッシュ)
+
+  std::string s = p.generic_system_encoded_string();
+  std::cout << s << std::endl;
+}
+```
+* p.generic_system_encoded_string()[color ff0000]
+
+### 出力
+```
+foo/bar
+```
+
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): 22 [mark noimpl]
+- [GCC](/implementation.md#gcc): 16.1 [mark noimpl]
+- [Visual C++](/implementation.md#visual_cpp): 2026 Update 2 [mark noimpl]
+
+
+## 関連項目
+- [`generic_string()`](generic_string.md) (この関数と同等の動作だが、C++26で非推奨)
+- [`generic_display_string()`](generic_display_string.md) (表示用のリテラルエンコーディングで取得する)
+- [`system_encoded_string()`](system_encoded_string.md) (システムフォーマットで取得する)
+
+
+## 参照
+- [P2319R5 Prevent path presentation problems](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p2319r5.html)
+    - 非推奨となった[`generic_string()`](generic_string.md)に代わり、システム依存エンコーディングへの変換であることを明確にしたこの関数がC++26で追加された

reference/filesystem/path/string.md

@@ -4,6 +4,7 @@
 * path[meta class]
 * function[meta id-type]
 * cpp17[meta cpp]
+* cpp26deprecated[meta cpp]
 
 ```cpp
 template <class EcharT,
@@ -15,6 +16,9 @@ std::basic_string<EcharT, traits, Allocator>
 std::string string() const;                       // (2)
 ```
 
+(2)は、C++26で非推奨となった。システム依存エンコーディングへの変換であることを明確にした[`system_encoded_string()`](system_encoded_string.md)、もしくは表示に適した[`display_string()`](display_string.md)を使用すること。
+
+
 ## 概要
 - (1) : 指定された文字型に対応する文字コードで、パス文字列を取得する
 - (2) : システムのマルチバイト文字コードで、パス文字列を取得する
@@ -37,6 +41,15 @@ std::string string() const;                       // (2)
     - POSIXベースシステムではUTF-8、Windowsの日本語環境ではCP932文字コードとなる
 
 
+## 非推奨の詳細 (C++26)
+(2)が返すシステム依存のパス名エンコーディングは、[iostream](/reference/iostream.md)・[`std::format()`](/reference/format/format.md)・[`std::print()`](/reference/print/print.md)を含むほぼすべての標準のテキスト処理・入出力機能と互換性がなく、文字化けやデータ損失の原因になりやすい。C++26ではこの問題を避けるために(2)が非推奨となり、用途に応じて以下の代替関数が追加された：
+
+- レガシーなシステムAPIにパスを渡す場合 : [`system_encoded_string()`](system_encoded_string.md) ((2)と同じ動作)
+- 表示・フォーマットする場合 : [`display_string()`](display_string.md)、[`std::format()`](/reference/format/format.md)、[`std::print()`](/reference/print/print.md)
+
+なお、テンプレート版である(1)は非推奨となっていない。
+
+
 ## 例
 ### POSIXベースシステムでの例
 ```cpp example
@@ -121,3 +134,14 @@ foo/bar
 - [Clang](/implementation.md#clang):
 - [GCC](/implementation.md#gcc): 8.1 [mark verified]
 - [Visual C++](/implementation.md#visual_cpp): 2017 Update 7 [mark verified]
+
+
+## 関連項目
+- [`system_encoded_string()`](system_encoded_string.md) (システム依存エンコーディングで取得する。(2)の代替)
+- [`display_string()`](display_string.md) (表示用のリテラルエンコーディングで取得する)
+- [`native()`](native.md) (システムの文字コードでパス文字列を取得する)
+
+
+## 参照
+- [P2319R5 Prevent path presentation problems](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p2319r5.html)
+    - 非テンプレート版の(2)がC++26で非推奨となり、[`system_encoded_string()`](system_encoded_string.md)・[`display_string()`](display_string.md)が代替として追加された