std::println

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

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

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

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

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

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

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

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

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

出力関数

出力関数

print (C++23)

println (C++23)

vprint_unicodevprint_unicode_buffered (C++23)(C++23)

vprint_nonunicodevprint_nonunicode_buffered (C++23)(C++23)

 

ヘッダ <print> で定義
template< class... Args > void println( std::format_string<Args...> fmt, Args&&... args );	(1)	(C++23から)
template< class... Args > void println( std::FILE* stream,               std::format_string<Args...> fmt, Args&&... args );	(2)	(C++23から)
void println();	(3)	(C++26以降)
void println( std::FILE* stream );	(4)	(C++26以降)

書式指定文字列 fmt にしたがって args を書式化し、末尾に '\n' を追加（出力が必ず改行で終わることを意味する）して、その結果をストリームに出力する。

1) std::println(stdout, fmt, std::forward<Args>(args)...) と等価。

2) 次の操作を行うのと等価

std::print(stream, "{}\n", std::format(fmt, std::forward<Args>(args)...));	(C++26まで)
std::print(stream, std::runtime_format(std::string(fmt.get()) + '\n'),            std::forward<Args>(args)...)	(C++26以降)

3) std::println(stdout) と等価。

4) std::print(stream, "\n") と等価。

Args 内の任意の `Ti` に対して std::formatter<Ti, char> が BasicFormatter 要件を満たさない場合（std::make_format_args で要求されるように）、動作は未定義である。

パラメーター

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

例外

• アロケーションに失敗した場合、std::bad_alloc。
• ストリームへの書き込みに失敗した場合、std::system_error。
• 使用されたフォーマッタによって投げられた例外（例：std::format_error）を伝播する。

備考

オーバーロード (3,4) は C++26 で追加されたが、既知の実装はすべて C++23 モードで利用可能にしている。

機能テストマクロ	値	規格	機能
__cpp_lib_print	202207L	(C++23)	書式付き出力
	202403L	(C++26)	バッファなし書式設定出力
__cpp_lib_format	202207L	(C++23)	std::basic_format_string の公開

例

このコードを実行

#include <print>
 
int main()
{
    // Each call to std::println ends with new-line
    std::println("Please"); // overload (1)
    std::println("enter"); // (1)
 
    std::print("pass");
    std::print("word");
 
    std::println(); // (3); valid since C++26; same effect as std::print("\n"); 
}

出力

Please
enter
password
 

関連項目

print (C++23)	引数の書式化された表現を用いて、stdoutまたはファイルストリームに出力する (関数テンプレート)
println(std::ostream) (C++23)	引数の書式化された表現に'\n'を付加して出力する (関数テンプレート)
format (C++20)	引数のフォーマット済み表現を新しい文字列に格納する (関数テンプレート)
printffprintfsprintfsnprintf (C++11)	stdout、ファイルストリーム、またはバッファにフォーマットされた出力を書き込む (関数)