std:: println (std::ostream)

定義済みヘッダー <ostream>
template < class ... Args > void println ( std:: ostream & os, std:: format_string < Args... > fmt, Args && ... args ) ;	(1)	(C++23以降)
void println ( std:: ostream & os ) ;	(2)	(C++26以降)

args を書式文字列 fmt に従ってフォーマットし（各出力は改行で終わることを意味する）追加の ' \n ' を付加し、その結果を os ストリームに挿入します。

std:: formatter < Ti, char > が BasicFormatter 要件を満たさない場合（ std:: make_format_args で要求される通り）、動作は未定義です。

目次 1 パラメータ 2 例外 3 注記 4 例 5 欠陥報告 6 関連項目

パラメータ

os	-	データを挿入する出力ストリーム
fmt	-	フォーマット文字列を表すオブジェクト。フォーマット文字列は以下で構成される： 通常の文字（ { と } を除く）は変更されずに出力にコピーされる エスケープシーケンス { { と } } は、出力ではそれぞれ { と } に置き換えられる 置換フィールド 各置換フィールドは以下の形式を持つ： { arg-id (optional) } (1) { arg-id (optional) : format-spec } (2) 1) フォーマット指定なしの置換フィールド 2) フォーマット指定ありの置換フィールド arg-id - フォーマットに使用する引数の args 内のインデックスを指定する。省略された場合、引数は順番に使用される。 フォーマット文字列内の arg-id はすべて存在するか、すべて省略されなければならない。手動インデックスと自動インデックスの混合はエラーである。 format-spec - 対応する引数に対する std::formatter 特殊化によって定義されるフォーマット仕様。 } で始めることはできない。 基本型と標準文字列型の場合、フォーマット仕様は 標準フォーマット仕様 として解釈される。 chrono型の場合、フォーマット仕様は chronoフォーマット仕様 として解釈される。 範囲型の場合、フォーマット仕様は 範囲フォーマット仕様 として解釈される。 std::pair と std::tuple の場合、フォーマット仕様は タプルフォーマット仕様 として解釈される。 std::thread::id と std::stacktrace_entry の場合、 スレッドIDフォーマット仕様 と スタックトレースエントリフォーマット仕様 を参照。 std::basic_stacktrace の場合、フォーマット指定子は許可されない。 (C++23以降) std::filesystem::path の場合、 パスフォーマット仕様 を参照。 (C++26以降) その他のフォーマット可能な型の場合、フォーマット仕様はユーザー定義の formatter 特殊化によって決定される。
args...	-	フォーマットする引数

例外

• std::bad_alloc メモリ確保失敗時に送出。
• 任意の フォーマッタ が送出する例外（例: std::format_error ）を、 os. exceptions ( ) の値に関わらず伝播し、 os のエラー状態における ios_base::badbit を設定しない。
• os への挿入が失敗した場合に呼び出される os. setstate ( ios_base :: badbit ) によって引き起こされる ios_base::failure を送出する可能性がある。

注記

C++26でオーバーロード ( 2 ) が追加されていますが、既知のすべての実装ではC++23モードで利用可能になっています。

機能テスト マクロ	値	標準	機能
__cpp_lib_print	202207L	(C++23)	フォーマット済み出力
__cpp_lib_format	202207L	(C++23)	std::basic_format_string の公開

例

このセクションは不完全です 理由: 例がありません

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

DR	Applied to	Behavior as published	Correct behavior
LWG 4088	C++23	( 1 ) 引数のフォーマットにおいて os に設定されたロケールを無視していた	そのようなロケールが使用される

関連項目

print (std::ostream) (C++23)	引数の フォーマット済み 表現を出力する (関数テンプレート)
println (C++23)	std::print と同じだが、各出力の後に改行が追加される (関数テンプレート)
format (C++20)	引数のフォーマット済み表現を新しい文字列に格納する (関数テンプレート)