Namespaces
Variants

std:: println

From cppreference.net
< cpp ‎ | io
C++
Input/output library
Print functions
Print functions
(C++23)
println
(C++23)
(C++23) (C++23)
(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 をフォーマットし（各出力は改行で終わることを意味する）、結果をストリームに出力します。

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 (optional) } (1)
{ arg-id (optional) : format-spec } (2)
1) フォーマット指定なしの置換フィールド
2) フォーマット指定ありの置換フィールド
arg-id - フォーマットに使用する args 内の引数のインデックスを指定する。省略された場合、引数は順番に使用される。

フォーマット文字列内の arg-id はすべて存在するか、すべて省略する必要がある。手動インデックスと自動インデックスの混合はエラーである。

format-spec - 対応する引数に対する std::formatter 特殊化によって定義されるフォーマット仕様。 } で始めることはできない。

(C++23以降)
(C++26以降)
  • その他のフォーマット可能な型の場合、フォーマット仕様はユーザー定義の formatter 特殊化によって決定される。
args... - フォーマットする引数

例外

注記

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

機能テスト マクロ 値 標準 機能
__cpp_lib_print 202207L (C++23) 書式付き出力
202403L (C++26) バッファリングなし書式付き出力 [1]
__cpp_lib_format 202207L (C++23) std::basic_format_string の公開
  1. ↑ P3107R5はDRとして採択されているものの、 std::runtime_format はC++26以降でのみ利用可能です。その結果、この解決策はC++23では適用できません。

例

このコードを実行 
#include <print>
int main()
{
    // std::printlnの各呼び出しは改行で終了する
    std::println("Please"); // オーバーロード (1)
    std::println("enter"); // (1)
    std::print("pass");
    std::print("word");
    std::println(); // (3); C++26以降有効; std::print("\n"); と同じ効果
}

出力: 

Please
enter
password

関連項目

(C++23)
引数の フォーマット済み 表現を使用して stdout またはファイルストリームに出力する
(関数テンプレート)
(C++23)
引数の フォーマット済み 表現を末尾に ' \n ' を追加して出力する
(関数テンプレート)
(C++20)
引数のフォーマット済み表現を新しい文字列に格納する
(関数テンプレート)
(C++11)
フォーマット済み出力を stdout 、ファイルストリーム、またはバッファに出力する
(関数)