C++26のStd::Formatにおける改善点
Improvements to Std:Format in C++26 (mariusbancila.ro)
要約
C++26標準では、formatライブラリに多くの改善が加えられています。主な変更点として、空行の直接出力、ポインタ型の直接フォーマット、`std::filesystem::path`のフォーマットが挙げられます。また、`std::format`関連関数が`constexpr`に対応し、実行時フォーマット文字列を扱う`std::dynamic_format`が導入されるなど、より柔軟で強力な文字列フォーマットが可能になります。
全文翻訳
C++26におけるstd::formatの改善点
C++26標準では、formatライブラリに一連の改善が施されます。この記事では、その中でも最も重要なものを見ていきます。
空行の出力
C++26以前は、空行を出力するには次のようにする必要がありました。
std::print("\n");
C++26では、std::printlnにパラメータなしのオーバーロードが追加され、コンソールに改行を出力します。
std::println();
ポインタのフォーマット
ポインタ型のフォーマットは直接利用できず、ポインタ型を整数型に再解釈するというハックが必要でした。
int i = 0;
const void* p = &i;
std::println("{:#018x}", reinterpret_cast<uintptr_t>(p));
C++26では、フォーマットライブラリがポインタ型のフォーマットを直接サポートします。
- 暗黙的: スペシファイアは不要です
- 明示的:
p(小文字)またはP(大文字)のスペシファイアを使用します
ヌルポインタは0x0としてフォーマットされます(パディングが指定されていない場合)。
ポインタのフォーマットの例をいくつか示します。
int i = 0;
const void* p = &i;
std::println("{}", p); // 小文字、デフォルト => 0x7fffb2715a54
std::println("{:p}", p); // 明示的、指定なしと同じ => 0x7fffb2715a54
std::println("{:P}", p); // 大文字 => 0X7FFFB2715A54
std::println("{:018}", p); // 幅18にゼロパディング => 0x00007fffb2715a54
std::println("{:>20}", p); // 幅20フィールドで右寄せ => 0x7fffb2715a54
std::println("{}", nullptr); // => 0x0
std::println("{:016}", nullptr); // => 0x00000000000000
パスのフォーマット
std::filesystem名前空間からのパスを出力する際にも、回避策が必要でした。パスの文字列表現を取得するためにpath::string()を使用できました。
namespace fs = std::filesystem;
fs::path p = "/usr/local/bin/clang++";
std::println("{}", p.string());
しかし、これはパスを引用符なしで出力します。一方、<<演算子を使用すると、パスが引用符で囲まれて出力されます。
std::cout << p << '\n';
C++26では、std::filesystem::path用のstd::formatterが追加され、パスのフォーマットが容易になりました。
- デフォルトでは、パスは引用符なしでフォーマットされます
?オプションは、エスケープされた表現(引用符付き)を提供するデバッグ形式を定義しますgオプションは、ジェネリック(フォワードスラッシュ)セパレータを強制します(これは主にWindowsで表示されます)
fs::path p = "/usr/local/bin/clang++";
std::println("{}", p); // /usr/local/bin/clang++
std::println("{:?}", p); // "/usr/local/bin/clang++"
fs::path p = R"(C:\Users\marius\file.txt)";
std::println("{}", w); // C:\Users\marius\file.txt (ネイティブセパレータ)
std::println("{:g}", w); // C:/Users/marius/file.txt (ジェネリック)
std::println("{:g?}", w); // "C:/Users/marius/file.txt" (ジェネリック + エスケープ)
関連する問題として、Windowsでのパスの文字列表現も解決されました。std::filesystem::pathは、そのテキストをUTF-16でエンコードされたwchar_t(Windowsネイティブ)に格納します。しかし、p.string()はそれをUTF-8ではなくアクティブなコードページに狭めます。フォーマットライブラリが期待するのはUTF-8です。結果として、ASCII以外のパスが文字化けに変換される可能性がありました。C++26のstd::formatter<std::filesystem::path>は、コードページを回避してUnicode変換を使用してWindowsネイティブUTF-16をUTF-8に変換するため、この問題を解決します。不正なUTF-16はデフォルトでU+FFFDに置き換えられるか、{:?}の下でエスケープされます。
constexpr std::format
C++26では、フォーマット関数std::format、std::vformat、std::format_to、std::format_to_n、std::formatted_size、およびそれらのワイドバリアント、さらに基盤となる部分(フォーマットコンテキスト、std::basic_format_arg、std::basic_format_string、標準フォーマッタのフォーマットメンバー)がconstexprになりました。
これにより、例えば次のような例でstatic_assertをstd::formatと共に使用することが可能になります。
static_assert(std::format("{} {}", 1, 2) == "1 2");
static_assert(sizeof(void*) == 8,
std::format("expected 64-bit, pointer is {} bytes", sizeof(void*)));
これは、constexpr化されたto_chars()オーバーロードに依存しているため機能しますが、整数型に対してのみです。そのため、文字列、整数型、bool、char、およびポインタで使用できます。しかし、この機能にはいくつかの制限があります。以下はサポートされていません。
- 浮動小数点型
- chrono型
- ロケール対応フォーマット(
Lスペシファイアの使用 -{:L}のように、呼び出しが定数でなくなる)
今のところ、コンパイル時std::formatは整数、文字列、診断をよくカバーしており、浮動小数点サポートは、浮動小数点<charconv>関数をconstexprにするための別の提案(P3652)を待っています。
std::runtime_format が std::dynamic_format になる
std::formatまたはstd::printのフォーマット文字列は定数式である必要があります。例えば、次のように記述できます。
std::println("{} = {}", "x", 13);
しかし、次のように記述することはできません。
std::string strf = "{} = {}";
std::println(strf, "x", 13);
これはstrfが実行時にのみ知られ、したがって定数式ではないため、不正な形式です。回避策はstd::vformatを使用することです。
const char* key = "y";
int val = 13;
std::string strf = "{} = {}";
std::string s = std::vformat(strf, std::make_format_args(key, val));
std::println("{}", s);
回避策の回避策(基本的にstd::vformatのシンタックスシュガー)があり、正式にはstd::runtime_format関数と呼ばれていました。これは、動的なフォーマット文字列を直接ユーザー指向のフォーマット関数で使用できるオブジェクトを返し、std::basic_format_stringに暗黙的に変換できます。
std::string strf = "{} = {}";
std::println(std::runtime_format(strf), "x", 13);
C++26の最終バージョンでは、これは単にstd::dynamic_formatに名前が変更されました(ただし、現時点ではこれをサポートするコンパイラは以前の名前を使用しています)。したがって、上記のコードスニペットは次のように変わります。
std::string strf = "{} = {}";
std::println(std::dynamic_format(strf), "x", 13);
std::dynamic_formatはconstexprであり、定数評価コンテキストで使用できることを意味します。例えば、次の例のように使用できます。
constexpr auto make_string = [](std::string_view f) {
return std::format(std::dynamic_format(f), 1, 2);
};
static_assert(make_string("{}+") == "1+2");
詳細情報
これらの変更について、以下の記事でさらに詳しく学ぶことができます。
- C++26: std::format improvement (Part 1)
- C++26: std::format improvements (Part 2)
[constexpr std::format](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3391r2.html)