std::print(std::ostream)

来自cppreference.com
< cpp‎ | io‎ | basic ostream
 
C++
 
输入/输出库
 
std::basic_ostream
 
在标头 <ostream> 定义
template< class... Args >
  void print( std::ostream& os, std::format_string<Args...> fmt, Args&&... args );
 (C++23 起)

根据格式字符串 fmt 格式化 args，将结果插入流 os。

如果通常字面量编码是 UTF-8，则上式等价于：

若 Args 中有任何 Ti，其 std::formatter<Ti, char> 不满足基本格式化器 (BasicFormatter) 要求，则其行为未定义（正如 std::make_format_args 所要求的）。

参数

os - 要插入数据的输出流
fmt -
用于表示格式字符串的对象。格式字符串由以下组成
  • 通常字符（除了 { 与 }），它们被不加修改地复制到输出，
  • 转义序列 {{ 与 }} ，它们在输出中被分别替换成 { 与 } ，以及
  • 替换域。

每个替换域拥有如下格式：

{ 实参索引 (可选) } (1)
{ 实参索引 (可选) : 格式说明 } (2)
1) 没有格式说明的替换域
2) 有格式说明的替换域
实参索引 - 指定用于格式化它的值的 args 中的参数的下标；如果省略实参索引，那么按顺序使用参数。

格式字符串中的实参索引 必须全部存在或全部被省略。混合手动和自动指定下标是错误。

格式说明 - 格式说明由对应参数特化的 std::formatter 定义。不能以 } 开始。

(C++23 起)
(C++26 起)
  • 对于其他可格式化类型，格式说明由用户定义的 std::formatter 特化决定。
args... - 参与格式化的实参

返回值

（无）

异常

  • 内存分配失败时抛出 std::bad_alloc。
  • 传播由其所使用的格式化器所抛出的任何异常，比如 std::format_error，不管 os.exceptions() 的值如何，也不会在 os 的错误状态中打开 ios_base::badbit。
  • 可能会抛出由 os.setstate(ios_base::badbit) 所造成的ios_base::failure，它是当向 os 的插入失败时调用的。

注解

功能特性测试宏 值 标准 功能特性
__cpp_lib_print 202207L (C++23) 格式化输出
__cpp_lib_format 202207L (C++23) 暴露 std::basic_format_string

示例

运行此代码
#include <array>
#include <cctype>
#include <cstdio>
#include <format>
#include <numbers>
#include <ranges>
#include <sstream>
 
int main()
{
    std::array<char, 24> buf;
    std::format_to(buf.begin(), "{:.15f}", std::numbers::sqrt2);
 
    unsigned num{}, sum{};
 
    auto v = buf
           | std::views::filter(isdigit)
           | std::views::transform([](char x) { return x - '0'; })
           | std::views::take_while([&sum](char) { return sum < 42; });
 
    for (auto n : v)
        sum += n, ++num;
 
    std::stringstream stream;
 
#ifdef __cpp_lib_print
    std::print(stream,
#else
    stream << std::format(
#endif
        "√2 = {}...\n"
        "其前 {} 位的和是 {}{}\n",
        std::numbers::sqrt2, num, sum, '。'
    );
 
    std::puts(stream.str().data());
}

输出： 

√2 = 1.4142135623730951...
其前 13 位的和是 42。

参阅

(C++23)
 输出各实参的格式化表示并追加 '\n'
(函数模板)
(C++23)
 将参数的格式化表达输出到 stdout 或文件缓冲区
(函数模板)
(C++20)
 在新字符串中存储参数的格式化表示
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/io/basic_ostream/print&oldid=91209”