std::print

 

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 print( std::format_string<Args...> fmt, Args&&... args );	(1)	(C++23から)
template< class... Args > void print( std::FILE* stream,             std::format_string<Args...> fmt, Args&&... args );	(2)	(C++23から)

フォーマット文字列 fmt に従って args をフォーマットし、結果を出力ストリームに出力する。

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

2) 通常のリテラルエンコーディングがUTF-8の場合、(std::enable_nonlocking_formatter_optimization<std::remove_cvref_t<Args>> && ...)
    ? std::vprint_unicode(stream, fmt.str, std::make_format_args(args...))
    : std::vprint_unicode_buffered(stream, fmt.str, std::make_format_args(args...)); と同等。

それ以外の場合、(std::enable_nonlocking_formatter_optimization<std::remove_cvref_t<Args>> && ...)
    ? std::vprint_nonunicode(stream, fmt.str, std::make_format_args(args...))
    : std::vprint_nonunicode_buffered(stream, fmt.str, std::make_format_args(args...)); と同等。

std::make_format_args で必要とされるように、Args のいずれかの Ti に対して std::formatter<Ti, char> が BasicFormatter 要件を満たさない場合、動作は未定義となる。

パラメータ

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）を伝播する。

注釈

機能テストマクロ	値	規格	機能
__cpp_lib_print	202207L	(C++23)	書式付き出力
	202403L	(C++26) (DR23)	バッファなしのフォーマット済み出力
	202406L	(C++26) (DR23)	より多くのフォーマット可能な型でバッファなしのフォーマット済み出力を有効にする
__cpp_lib_format	202207L	(C++23)	std::basic_format_string の公開

例

このコードを実行

#include <cstdio>
#include <filesystem>
#include <print>
 
int main()
{
    std::print("{2} {1}{0}!\n", 23, "C++", "Hello");  // overload (1)
 
    const auto tmp{std::filesystem::temp_directory_path() / "test.txt"};
    if (std::FILE* stream{std::fopen(tmp.c_str(), "w")})
    {
        std::print(stream, "File: {}", tmp.string()); // overload (2)
        std::fclose(stream);
    }
}

出力

Hello C++23!

欠陥レポート

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
P3107R5	C++23	バッファリングされた出力操作のみが可能	バッファなし出力操作を実行できる
P3235R3	C++23	追加された関数の名前 P3107R5 によって誤解を招くものだった	関数名を変更した

関連項目

println (C++23)	std::printと同じだが、各出力の末尾に改行が追加される点が異なる (関数テンプレート)
print(std::ostream) (C++23)	引数の書式化された表現を出力する (関数テンプレート)
format (C++20)	引数のフォーマット済み表現を新しい文字列に格納する (関数テンプレート)
format_to (C++20)	引数のフォーマット済み表現を出力イテレータを介して書き出す (関数テンプレート)
printffprintfsprintfsnprintf (C++11)	stdout、ファイルストリーム、またはバッファにフォーマットされた出力を書き込む (関数)