#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

#格式占位符

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

• 宽度：打印的宽度，内容不足时使用空格或 0 补全
• 精度：小数点后显示的位数
• 长度修饰：表示类型长度，例如 %d 是 int，而 %ld 是 long

#特殊格式宏

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

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

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

#推荐阅读

• stdint.h
• inttypes.h
• File input/output - printf