标准I/O库之格式化I/O

本篇博文内容摘自《UNIX环境高级编程》(第二版),仅作个人学习记录所用。关于本书可参考:http://www.apuebook.com/

一、格式化输出

执行格式化输出处理的是4个printf函数。

#include <stdio.h>

int printf( const char *restrict format, ... );
int fpritnf( FILE *restrict fp, const char *restrict fromat, ... );
两个函数的返回值:若成功则返回输出字符数,若输出出错则返回负值 int sprintf( char *restrict buf, const char *restrict format, ... );
int snprintf( char *restrict buf, size_t n, const char *restrict format, ... );
两个函数返回值:若此成功则返回存入数组的字符数,若编码出错则返回负值

printf将格式化数据写到标准输出,fprintf写至指定的流,sprintf将格式化的字符送入数组buf中。sprintf在该数组的尾端自动加一个null字节,但该字节不包括在返回值中。

注意,sprintf函数可能会造成由buf指向的缓冲区的溢出。调用者有责任确保该缓冲区足够大。为了解决这种缓冲区溢出的问题,引入了snprintf函数。在该函数中,缓冲区长度是一个显示参数,超过缓冲区尾端写的任何字符都会被丢弃。如果缓冲区足够大,snprintf函数就会返回写入缓冲区的字符数。与sprintf相同,该返回值不包括结尾的null字节。若snprintf函数返回小于缓冲区长度n的正值,那么没有截短输出。若发生了一个编码错误,snprintf则返回负值。

格式说明控制其余参数如果编写,以后又如何显示。每个参数按照转换说明编写,转换说明以字符%开始,除转换说明外,格式字符串中的其他字符将按原样,不经任何修改地被复制输出。一个转换说明有4个可选部分,下面将它们都示于方括号中:

%[flags] [fldwidth] [precision] [lenmodifier] convtype

表5-5 转换说明中的标志部分

标志 说明
- 在字段内左对齐输出
+ 总是显示带符号转换的符号
(空格) 如果第一个字符不是符号,则在其前面加上一个空格
# 指定另一种转换形式(例如,对于十六进制格式,加0x前缀
0 添加前导0(而非空格)进行填充

fldwidth说明转换的最小字段宽度。如果转换得到的字符较少,则用空格填充它。字段宽度是一个非负十进制数,或是一个星号(*)。

precision说明整型转换后最少输出数字位数、浮点数转换后小数点后的最少位数、字符串转换后的最大字符数。精度是一个句点(.),后接一个可选的非负十进制整数或一个星号(*)。

宽度和精度字段两者皆可为*。此时,一个整型参数指定宽度或精度的值。该整型参数正好位于被转换的参数之前。(注意对这句话的理解)。我们还是用一个实例来说明比较容易接受:

我们可以直接在fldwidth位置用一个整数10指定输出宽度:

printf("%10d\n", );

也可以在fldwidth位置用*,而把指定宽度参数10放在转换说明后面,被转换的参数之前:

printf("%*d\n", , );

lenmodifier说明参数长度。其可能的取值示于表5-6中。

表5-6 转换说明中的长度修饰符

长度修饰符 说明
hh 有符号或无符号的char
h 有符号或无符号的short
l 有符号或无符号的long或者宽字符
ll 有符号或无符号的long long
j intmax_t或uintmax_t
z size_t
t ptrdiff_t
L long double

convtype不是可选的。它控制如何解释参数。表5-7中列出了各种转换类型。

表5-7 转换说明中的转换类型部分

转换类型 说明
d、i 有符号十进制
o 无符号八进制
u 无符号十进制
x、X 无符号十六进制
f、F double精度浮点数
e、E 指数格式的double精度浮点数
g、G 解释为f、F、e或E,取决于被转换的值
a、A 十六进制指数格式的double精度浮点数
c 字符(若带长度修饰符l,则为宽字符)
s 字符串(若带长度修饰符l,则为宽字符串)
p 指向void的指针
n 将到目前为止,所写的字符数写入到指针所指向的无符号整型中
% %字符
C 宽字符(XSI扩展,等效于lc)
S 宽字符串(XSI扩展,等效于ls)

下列4中printf族的变体类似于上面的4种,但是可变参数表(...)代换成了arg。

#include <stdarg.h>
#include <stdio.h> int vprintf( const char *restrict format, va_list arg );
int vfprintf( FILE *restrict fp, const char *restrict format, va_list arg );
两个函数返回值:若成功则返回输出字符数,若输出出错则返回负值 int vsprintf( char *restrict buf, const char *restrict format, va_list arg );
int vsnprintf( char *restrict buf, size_t n, const char *restrict format, va_list arg );
两个函数返回值:若成功则返回存入数组的字符数,若编码出错则返回负值

关于可变参数列表可参考《C和指针》7.6:Variable Argument Lists。

二、格式化输入

执行格式化输入处理的是三个scanf函数。

#include <stdio.h>

int scanf( const char *restrict format, ... );
int fscanf( FILE *restrict fp, const char *restrict format, ... );
int sscanf( const char *restrict buf, const char *restrict format, ... );
三个函数返回值:若成功则返回指定的输入项数;若输入出错或在任意变换前已到达文件结尾则返回EOF

scanf族用于分析输入字符串,并将字符序列转换成指定类型的变量。格式之后的各参数包含了变量的地址,以用转换结果初始化这些变量。

格式说明控制如何转换参数,以便对它们赋值。转换说明以%字符开始。除转换说明和空白字符外,格式字符串中的其他字符必须与输入匹配。若有一个字符不匹配,则停止后续处理,不再读输入的其余部分。

一个转换说明有三个可选部分,下面将它们都示于方括号中:

%[*] [fldwidth] [lenmodifier] convtype

可选的前导星号(*)用于抑制转换。按照转换说明的其余部分对输入进行转换,但转换结果并不存放在参数中。

fldwidth说明最大宽度(即最大字符数)。

lenmodifier说明要用转换结果初始化的参数大小。由printf函数族支持的长度修饰符同样得到scanf函数族的支持(见表5-6中的长度修饰符列表)。

convtype字段类似于printf族的转换类型字段,但两者之间还有些差别。一个差别是,存储在无符号类型中的结果可在输入时带上符号。例如,-1可被转换成4 294 967 295赋予无符号整型变量。表5-8列出了scanf函数族支持的转换类型。

表5-8 转换说明中的转换类型

转换类型 说明
d 有符号十进制,基数为10
i 有符号十进制,基数由输入格式决定
o 无符号八进制(输入可选地有符号)
u 无符号十进制,基数为10(输入可选地有符号)
x 无符号十六进制(输入可选地有符号)
a、A、e、E、f、F、g、G 浮点数
c 字符(若带长度修饰符l,则为宽字符)
s 字符串(若带长度修饰符l,则为宽字符串)
[ 匹配列出的字符序列,以]终止
[^ 匹配除列出字符以外的所有字符,以]终止
p 指向void的指针
n 将到目前为止读取的字符数写入到指针所指向的无符号整型中
% %字符
C 宽字符(XSI扩展,等效于lc)
S 宽字符串(XSI扩展,等效于ls)

与printf族一样,scanf族也支持函数使用由<stdarg.h>说明的可变参数表。

#include <stdarg.h>
#include <stdio.h> int vscanf( const char *restrict format, va_list arg );
int vfscanf( FILE *restrict fp, const char *restrict format, va_list arg );
int vsscanf( const char *restrict buf, const char *restrict format, va_list arg );
三个函数返回值:指定的输入项数,若输入出错或在任一变换前已到达文件结尾则返回EOF
上一篇:Genymotion中SD卡目录在Eclipse中查看,以及创建SDCard


下一篇:mvc导航配置(View页面)