标准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 转换说明中的标志部分

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

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

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

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

printf("%10d/n", 123);

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

printf("%*d/n", 10, 123);

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

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

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

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

下列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 转换说明中的转换类型

与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