printf函数用法小记

Posted 2020-10-04 刘英皓

By francis_hao    Aug 26,2017

 

C语言中printf函数是一个比较常用的函数，但是常用并不代表完全了解，本文翻译了printf的man手册，介绍了其全部功能（不包括man手册中不建议使用的）。

 

printf – 格式化输出转换

概述

#include <stdio.h> int printf(const char *format, ...);

 

描述

printf()函数通过给定的format产生格式化的输出。

若函数执行成功，返回打印的字节数（不包括字符串结尾的null字节）。若出错，则返回一个负值。

format的格式

format是一个字符串，可以由普通字符和(或)一组转换说明组成。普通字符会直接被拷贝到输出流，不会做任何改变。而转换说明会把后面的参数取来按照自己的格式进行转换。每组转换说明由字符"%"引入，以一个转换说明符结束。在它们之间，可以（按此顺序）包含零个或多个标志，一个可选的最小字段宽度，一个可选的精度和一个可选的长度修饰符。

format后面的参数必须正确地对应相应的转换说明符。默认情况下，参数按给定的顺序使用，每个"*"和每个转换说明符需要吸取一个参数（参数不够会出错）。但是，用户也可以明确地指定需要哪个参数，在需要参数的位置用"%m$"代替"%"，用"*m$"代替"*"，m是一个十进制整数，用以指定需要的参数的位置，位置从1开始索引。所以

printf("%*d", width, num);

和

printf("%2$*1$d", width, num);

是等价的。这里"*"的用法需要注意，正如上面所讲，"*"也要吸取一个参数，因此

printf("%*d", 2, 5);

和

printf("%2d", 5);

是等价的

标志字符

字符"%"后面可以跟下面一个或多个标志

标志	说明
#	数值应转换成对应的形态，例如，"o"转换符会在数值的第一个字节添加0，"x"和"X"转换符会添加"0x"和"0X"。对于a，A，e，E，f，F，g和G转换符，输出的结果总包含一个小数点，即使其后没有小数位。对于其他转换符，结果是未定义的。
0	数值应由0填充，对于d，i，o，u，x，X，a，A，e，E，f，F，g和G转换符来说，转换结果从左侧填充0而不是默认的空格，如果0和-同时指定，0被忽略，如果指定了精度，d，i，o，u，x和X的0标志被忽略，其他转换符，结果是未定义的。
-	转换结果调整成左对齐，默认为右对齐。如果0和-同时指定，0被忽略
\' \'	一个空格，数值是一个有符号数的情况下，若是正数则空出一个空格。效果如下：
+	符号（+或-）总是出现在数值之前，默认正数是没有+号的。如果加号和上面的空格同时指定，空格被忽略。

字段长度

一个可选的十进制字串（第一个数字不为0）指定了一个字段的最小长度。如果要被转化的值的字符长度小于指定的长度，那么将会在左侧以空格填充（或者在右侧，如果指定了左对齐选项\'-\'）。除了十进制数字，也可以通过\'*\'或"*m$"来以其后的参数指定字段长度，此参数必须是int类型。

精度

可选的精度，形式是\'.\'后面跟着一个十进制数字串。除了十进制数字，也可以通过\'*\'或"*m$"来以其后的参数指定字段长度，此参数必须是int类型。如果只给出一个\'.\'或者精度是个负数，那么精度被设置为0。对于不同的转换符，精度有着不同的含义，分别如下：
1、对于d, i, o, u, x, 和 X转换符，精度指定了其最小数字长度（不足在前面补0）
2、对于a, A, e, E, f, 和 F转换符，精度指定了其小数位数（不足的在后面补0）
3、对于g和G转换符，精度指定了最大有效数字位数
4、对于s和S转换符，精度指定了要打印字符串的最大长度

长度修饰符

这里的整数转换符代表了d, i, o, u, x, 和X转换符。

hh	其后的整数转换符对应一个signed char或unsigned char参数 其后的n转换符对应一个指向signed char参数
h	其后的整数转换符对应一个short int或unsigned short int参数 其后的n转换符对应一个short int参数
l	其后的整数转换符对应一个long int或unsigned long int参数 其后的n转换符对应一个long int参数 其后的c转换符对应一个wint_t参数 其后的s转换符对应一个指向wchar_t类型指针的参数
ll	其后的整数转换符对应一个long long int 或 unsigned long long int参数 其后的n转换符对应一个long long int参数
L	其后的a, A, e, E, f, F, g和 G转换符对应一个long double参数
j	其后的整数转换符对应一个intmax_t或uintmax_t参数
z	其后的整数转换符对应一个size_t或ssize_t参数
t	其后的整数转换符对应一个ptrdiff_t参数

转换说明符

d, i	将int类型参数转换成有符号的十进制记法，如果指定精度，表示最少要出现的数字的长度，如果少于此长度，默认在左侧补0。默认的精度是1，如果打印0，而且指定精度为0，那将只会打印空字符。
o, u, x, X	将unsigned int类型参数转换成 o：无符号八进制记法 u：无符号十进制记法 x和X：无符号十六进制记法 如果指定精度，表示最少要出现的数字的长度，如果少于此长度，默认在左侧补0。默认的精度是1，如果打印0，而且指定精度为0，那将只会打印空字符。
e, E（大小写区分）	将double类型参数转换成形如[-]d.ddde±dd的风格。精度说明了小数点后的位数，默认为6
f, F	将double类型参数转换成形如[-]ddd.ddd的风格。精度说明了小数点后的位数，默认为6
g, G	将double类型参数转换成 g：f或e风格 G：F或E风格 精度指定了有效数字位数（比如1.23000的有效数字位数为3（1.23））。默认为6，如果精度指定为0，则认为是1。 e转换符风格在数值的指数小于-4或者大于等于精度值时才会用到，其他情况使用f风格。输出结果会移除小数点后无效的0。
a, A（大小写区分）	将double类型参数转换成十六进制记法，形如[-]0xh.hhhhp±。精度指定小数点后位数
c	如果没有指定l修饰符，则将int类似的参数转换成unsigned char并将对应的字符写入
s	如果没有指定l修饰符，则将const char *参数指向的字符串输出，直到遇到null字符。 但是，如果指定了精度，则只输出相应数量的字符。
p	将void *类型参数输出为十六进制（类似%#x or %#lx）
n	将此次调用已经写过的字符的数量存储在int *指定的参数中，此项不是转换操作，是唯一的结果参数。 例如printf("01234%n\\n",&num);会将%n前面的字符数量5存储在num里。
m (Glibc extension.)	打印strerror(errno)，不需要参数

 

 

本文由 刘英皓 创作，采用 知识共享 署名-非商业性使用-相同方式共享 3.0 中国大陆 许可协议进行许可。欢迎转载，请注明出处：
转载自：http://www.cnblogs.com/yinghao1991/p/7434765.html

 

 

参考

【1】man 3 printf

【2】CSDN http://blog.csdn.net/xiaodao1986/article/details/8209567 printf中有趣的%n