printf函数用法小记

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 ",&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

原文地址:https://www.cnblogs.com/yinghao-liu/p/7434765.html