最終更新日時: 2026年07月22日 16時08分23秒 (JST)
rotarymars が更新

履歴 編集

function template
<print>

# std::print(C++23)

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

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

## 概要

書式指定で出力する。

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

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

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

この関数は、末尾に改行コードが付かないことに注意。改行コードを自動で付けたい場合は、`std::println()`関数を使用すること。

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

## 効果

- (1) : 以下と等価：

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

- (2) :

  - C++23 :

    - 通常の文字列リテラルがUTF-8エンコーディングされている場合、以下と等価：

          vprint_unicode(stream, fmt.get(), make_format_args(std::forward<Args>(args)...));

    - そうでなければ、以下と等価：

        vprint_nonunicode(stream, fmt.get(), make_format_args(std::forward<Args>(args)...));

  - C++26 :

    - 値として`(enable_nonlocking_formatter_optimization<remove_cvref_t<Args>> && ...)`をもつ変数`locksafe`があるとして、

    - 通常の文字列リテラルがUTF-8エンコーディングされている場合、以下と等価：

          locksafe
            ? vprint_unicode(stream, fmt.get(), make_format_args(args...))
            : vprint_unicode_buffered(stream, fmt.get(), make_format_args(args...));

    - そうでなければ、以下と等価：

        locksafe
          ? vprint_nonunicode(stream, fmt.get(), make_format_args(args...))
          : vprint_nonunicode_buffered(stream, fmt.get(), make_format_args(args...));

## 備考

- LinuxやmacOSといった環境では、通常の`char`配列の文字列リテラルはUTF-8にエンコーディングされる
- WindowsのVisual Studioにおいては、ソースコードと実行時文字集合をUTF-8にする`/utf-8`オプションを使用することで、通常の`char`配列の文字列リテラルがUTF-8にエンコーディングされる
- 「通常の文字列リテラルがUTF-8エンコーディングされている場合」という仕様は、コードでは以下のように表現できる：

      constexpr bool is_utf8() {
        const unsigned char micro[] = "\u00B5";
        return sizeof(micro) == 3 && micro[0] == 0xC2 && micro[1] == 0xB5;
      }

      template <typename... Args>
      void print(string_view fmt, const Args&... args) {
        if (is_utf8())
          vprint_unicode(fmt, make_format_args(args...));
        else
          vprint_nonunicode(fmt, make_format_args(args...));
      }

## 例

### 基本的な使い方

    #include <print>

    int main()
    {
      std::print("Hello {} World\n", 42);

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

#### 出力

    Hello 42 World
    Hello 42 World
    Hello 42 World

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

    import std;
    #include <cstdio>

    int main()
    {
      std::print("Hello {} World\n", 42);

      // stdout / stderrはマクロとして定義される。
      // モジュールはマクロをエクスポートしないので、
      // stdout / stderrを使用する場合は<cstdio>をインクルードする必要がある
      std::print(stdout, "Hello {} World\n", 42);
    }

#### 出力

    Hello 42 World
    Hello 42 World

### 実行時の書式文字列を使用する (C++26)

    #include <print>
    #include <string>

    int main()
    {
      std::string fmt = "{}\n";
      std::print(std::dynamic_format(fmt), "Hello");
    }

#### 出力

    Hello

## バージョン

### 言語

- C++23

### 処理系

- Clang: 19 ✅
- GCC: 14 ✅
- ICC: ??
- Visual C++: 2022 Update 7 ✅

## 関連項目

- `std::format()`
- `std::dynamic_format()`
- `std::println()`

## 参照

- P2093R14 Formatted output
- P3107R5 Permit an efficient implementation of `std::print`
- P3235R3 `std::print` more types faster with less memory
  - C++26の上記2つの提案文書では、余分な動的メモリ確保をしないよう仕様が見直された