#C 语言标准库函数 printf

/*********************************************
 * @brief 向标准输出中进行输出
 * @param format 格式字符串
 * @param ... 可变长度参数，要打印的变量
 * @return 打印的字符数量
 ********************************************/
int printf(const char* restrict format, ...);

说明

向标准输出中进行输出。

参数

• format - 格式化字符串，指向以空字符（\0）结尾的字符串指针，指定如何解释数据
  • 普通字符直接打印
  • 转义字符 按照转义打印
  • 以 % 开头的 格式占位符，按照指定格式打印后续相应位置的参数
• ... - 可变长度参数，为要打印的变量，需要与 format 参数中的格式占位符一一对应

返回值

• 成功时返回打印的字符数量
• 失败时返回负值

#示例

#include <stdio.h>

int main(void)
{
    int x = 1024;
    float y = 3.1415926;
    char ch = '@';
    char* text = "hello";

    printf("x=%d, y=%f, ch=%c, text=%s\n", x, y, ch, text);

    return 0;
}

运行结果：

x=1024, y=3.141593, ch=@, text=hello

#转义字符

转义字符用于表示一些无法直接表示的字符，例如 \n 表示换行，以下是转义字符表：

#格式占位符

格式占位符以 %[标识][最小宽度][.精度][长度修饰]说明符 的形式出现。

• 最小宽度：打印的最小宽度，内容不足时使用空格或 0 补全
  • 如果使用一个星号（*），则消耗一个 int 型参数作为最小宽度
• 精度：指定转换的精度
  • 如果使用一个星号（*），则消耗一个 int 型参数作为精度
  • 对于正数数（%d 等），表示最小位数
  • 对于浮点数（%f 等），表示小数点后的位数
  • 对于字符串（%s），表示最大宽度
• 长度修饰：表示类型长度，例如 %d 是 int，而 %ld 是 long

#特殊格式宏

由于 C 语言中类型的长度不是固定的。反过来说，固定长度的类型，其原始类型是不确定的。

例如 int32_t 在某些环境下是 int，另外某些环境下是 long；前者使用 printf 打印时应使用 %d，而后者应使用 %ld。

为了方便，可以使用以下宏来标识格式。

#推荐阅读

• C 语言标准库函数 scanf
• stdint.h
• inttypes.h
• File input/output - printf

#参考标准

• C23 standard (ISO/IEC 9899:2024):
  • 7.21.6.3 The printf function (p: TBD)
• C17 standard (ISO/IEC 9899:2018):
  • 7.21.6.3 The printf function (p: 236)
• C11 standard (ISO/IEC 9899:2011):
  • 7.21.6.3 The printf function (p: 324)
• C99 standard (ISO/IEC 9899:1999):
  • 7.19.6.3 The printf function (p: 290)
• C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.6.3 The printf function