println.md

println

• print[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp23[meta cpp]

namespace std {
  template <class... Args>
  void println(format_string<Args...> fmt,
               Args&&... args);             // (1) C++23

  template <class... Args>
  void println(FILE* stream,
               format_string<Args...> fmt,
               Args&&... args);             // (2) C++23
}

• format_string[link /reference/format/basic_format_string.md]
• FILE[link /reference/cstdio/file.md.nolink]

概要

書式指定で出力する。この関数は、出力の末尾に改行コードが自動で付加される。

書式はstd::format()関数のページを参照。

この関数は、std::printf()関数ライクな書式指定で引数を文字列化して出力する。

• (1) : 標準出力に、書式指定で出力する
• (2) : 指定されたFILEに、書式指定で出力する

この関数は、末尾に改行コードが付くことに注意。改行コードが不要な場合は、std::print()関数を使用すること。

std::ostreamから派生したクラスオブジェクトに対して出力したい場合は、<ostream>ヘッダのstd::print()関数を使用すること。

効果

• (1) : 以下と等価：

  println(stdout, fmt, std::forward<Args>(args)...);

  • stdout[link /reference/cstdio/stdout.md.nolink]
  • std::forward[link /reference/utility/forward.md]

• (2) : 以下と等価：

  print(stream, "{}\n", format(fmt, std::forward<Args>(args)...));

  • print[link print.md]
  • format[link /reference/format/format.md]
  • std::forward[link /reference/utility/forward.md]

例

基本的な使い方

#include <print>

int main()
{
  std::println("Hello {} World", 42);

  // 出力先を指定
  std::println(stdout, "Hello {} World", 42); // 標準出力に出力
  std::println(stderr, "Hello {} World", 42); // 標準エラーに出力
}

• std::println[color ff0000]

出力

Hello 42 World
Hello 42 World
Hello 42 World

モジュールをインポートする例

import std;
import std.compat;

int main()
{
  std::println("Hello {} World", 42); // OK

  // stdout / stderrはマクロとして定義される。
  // モジュールはマクロをエクスポートしないので、
  // stdout / stderrは使用できない
  // std::println(stdout, "Hello {} World", 42); // エラー！stdoutが見つからない
}

出力

Hello 42 World

バージョン

言語

• C++23

処理系

• Clang: ??
• GCC: ??
• ICC: ??
• Visual C++: ??

関連項目

• std::format()
• std::print()

参照

• P2093R14 Formatted output