C++中能否在自定义函数中使用格式说明符？

你希望在自定义函数里实现类似printf()的格式说明符功能——比如通过%d这类占位符插入变量，就像printf("The number is %d", num)那样。你尝试的代码如下：

void output(std::string message)
{
  std::cout << message << '\n';
}

int main()
{
  int num = 123;
  output("The number is %d", num);

  return 0;
}

但这段代码无法正常解析%d占位符，你了解到可变参数函数可能是解决方案，下面就具体说明实现方式：

可以实现，可变参数是正确的解决方案 #

在C++里，有几种方式能实现这类带格式说明符的自定义函数，下面是最常用的三种：

1. C风格可变参数（兼容C语言） #

这种方式和printf的底层实现逻辑一致，借助<cstdarg>头文件里的va_list、va_start、va_end宏来处理可变参数，搭配C标准库的vprintf函数完成格式化：

#include <iostream>
#include <cstdarg>
#include <cstdio>

void output(const char* format, ...)
{
    va_list args;
    va_start(args, format); // 初始化可变参数列表
    
    // 用vprintf处理格式化输出，等价于printf但接收va_list参数
    vprintf(format, args);
    putchar('\n'); // 追加换行
    
    va_end(args); // 清理可变参数列表
}

int main()
{
    int num = 123;
    output("The number is %d", num);
    output("Number: %d, Float: %.2f, String: %s", 456, 3.14f, "Hello");
    return 0;
}

这种方式的优点是简单直接，缺点是类型不安全——编译器不会检查参数类型和格式说明符是否匹配，容易出现运行时错误。

2. C++11+可变模板参数（类型安全） #

如果想要更符合C++风格的类型安全实现，可以用可变模板参数结合std::stringstream来构建格式化字符串：

#include <iostream>
#include <sstream>
#include <string>

// 递归终止函数：无剩余参数时输出最终字符串
void output(const std::string& result)
{
    std::cout << result << '\n';
}

// 可变模板函数：逐个替换占位符并递归处理剩余参数
template<typename T, typename... Args>
void output(const std::string& format, T&& value, Args&&... args)
{
    size_t placeholder_pos = format.find("%");
    if (placeholder_pos == std::string::npos)
    {
        std::cout << format << '\n';
        return;
    }

    // 拼接当前部分的字符串和参数，继续处理剩余格式和参数
    std::stringstream ss;
    ss << format.substr(0, placeholder_pos) << std::forward<T>(value);
    output(ss.str() + format.substr(placeholder_pos + 2), std::forward<Args>(args)...);
}

int main()
{
    int num = 123;
    output("The number is %d", num);
    output("Int: %d, Double: %lf, String: %s", 789, 2.718, "World");
    return 0;
}

这种方式的核心是通过递归逐个处理每个参数，替换掉格式字符串中的占位符，编译器会严格检查参数类型，避免类型不匹配的问题。

3. C++20 std::format（现代推荐方式） #

如果你使用C++20或更高版本，推荐直接使用标准库的std::format，它提供了更简洁、类型安全的格式化语法（用{}代替%d这类占位符）：

#include <iostream>
#include <format>

void output(std::format_string<auto...> fmt, auto&&... args)
{
    std::cout << std::format(fmt, std::forward<decltype(args)>(args)...) << '\n';
}

int main()
{
    int num = 123;
    output("The number is {}", num);
    output("Int: {}, Double: {:.2f}, String: {}", 456, 3.14, "Hello");
    return 0;
}

std::format支持丰富的格式化选项，比如指定小数位数、对齐方式等，是目前C++中格式化字符串的最优方案。

内容的提问来源于stack exchange，提问作者user29337117