# C 语言标准库函数 printf

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

!subtitle:说明

向标准输出中进行输出。

!subtitle:参数

• format - 格式化字符串，指向以空字符（\0）结尾的字符串指针，指定如何解释数据

  • 普通字符直接打印

  • 转义字符) 按照转义打印

  • 以 % 开头的 格式占位符，按照指定格式打印后续相应位置的参数

• ... - 可变长度参数，为要打印的变量，需要与 format 参数中的格式占位符一一对应

!subtitle:返回值

• 成功时返回打印的字符数量

• 失败时返回负值

# 示例

#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