std::enable_nonlocking_formatter_optimization

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

書式設定ライブラリ

標準フォーマット指定

フォーマット関数

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

フォーマット文字列

basic_format_stringformat_stringwformat_string (C++20)(C++20)(C++20)

runtime_format (C++26)

フォーマット関連コンセプト

formattable (C++23)

フォーマッタ

formatter (C++20)

formatter<pair-or-tuple> (C++23)

formatter<range> (C++23)

range_formatter (C++23)

enable_nonlocking_formatter_optimization (C++23)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)

basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)

range_format (C++23)

format_kind (C++23)

フォーマット引数

basic_format_arg (C++20)

basic_format_arg::handle (C++20)

basic_format_argsformat_argswformat_args (C++20)(C++20)(C++20)

visit_format_arg (C++20) (C++26で非推奨)

make_format_argsmake_wformat_args (C++20)(C++20)

フォーマットエラー

format_error (C++20)

 

ヘッダー <format> で定義
template< class T > constexpr bool enable_nonlocking_formatter_optimization = false;		(C++23から)

このテンプレートは、実装が std::print および std::println の効率的な実装を有効にするために使用できます。

std::enable_nonlocking_formatter_optimization<T> が true の場合、型 T の引数をより効率的な方法で出力できます（詳細は std::print を参照）。std::enable_nonlocking_formatter_optimization の特殊化は、以下のケースで true になることがあります。

• T が、std::formatter<T, CharT> が 基本的な標準特殊化 または ライブラリ型のための標準特殊化 のいずれかである型である場合（下記参照）。
• プログラムは、任意の cv 修飾されていない プログラム定義型 T に対してこのテンプレートを特殊化できます。そのような特殊化は、定数式で使用可能でなければならず、型は const bool でなければなりません。

基本的な標準特殊化

以下のリストでは、CharT は char または wchar_t のいずれかであり、ArithmeticT は char、wchar_t、char8_t、char16_t、または char32_t 以外の任意の cv 修飾されていない算術型です。

文字フォーマッタの非ロックフラグ
template<> constexpr bool enable_nonlocking_formatter_optimization<CharT> = true;	(1)
文字列フォーマッタの非ロックフラグ
template<> constexpr bool enable_nonlocking_formatter_optimization<CharT*> = true;	(2)
template<> constexpr bool enable_nonlocking_formatter_optimization<const CharT*> = true;	(3)
template< std::size_t N > constexpr bool enable_nonlocking_formatter_optimization<CharT[N]> = true;	(4)
template< class Traits, class Alloc > constexpr bool enable_nonlocking_formatter_optimization     <std::basic_string<CharT, Traits, Alloc>> = true;	(5)
template< class Traits > constexpr bool enable_nonlocking_formatter_optimization     <std::basic_string_view<CharT, Traits>> = true;	(6)
算術フォーマッタの非ロックフラグ
template<> constexpr bool enable_nonlocking_formatter_optimization<ArithmeticT> = true;	(7)
ポインタフォーマッタの非ロックフラグ
template<> constexpr bool enable_nonlocking_formatter_optimization<std::nullptr_t> = true;	(8)
template<> constexpr bool enable_nonlocking_formatter_optimization<void*> = true;	(9)
template<> constexpr bool enable_nonlocking_formatter_optimization<const void*> = true;	(10)

ライブラリ型のための標準特殊化

以下の標準テンプレートのすべての特殊化に対する enable_nonlocking_formatter_optimization の特殊化は、true として定義されています。

• std::chrono::zoned_time （そのテンプレートパラメータ型 TimeZonePtr が const std::chrono::time_zone* である場合）

以下の標準テンプレートのすべての特殊化に対する enable_nonlocking_formatter_optimization の特殊化は、条件付きで true として定義されています。

• std::pair
• std::tuple
• std::chrono::duration

すべての フォーマット可能な範囲型 に対する enable_nonlocking_formatter_optimization の特殊化は、範囲フォーマットの種類が std::range_format::disabled でない場合は常に false として定義されます。

注記

機能テストマクロ	値	規格	機能
__cpp_lib_print	202403L	(C++26) (DR23)	ストリームロッキングによるフォーマット済み出力
	202406L	(C++26) (DR23)	より多くのフォーマット可能型に対する非ロックフォーマッタ最適化の有効化

関連項目

formatter (C++20)	与えられた型のフォーマット規則を定義する (クラステンプレート)
print (C++23)	引数の書式化された表現を用いて、stdoutまたはファイルストリームに出力する (関数テンプレート)
println (C++23)	std::printと同じだが、各出力の末尾に改行が追加される点が異なる (関数テンプレート)