标准IO
标准 I/O 虽然是对文件 I/O 进行了封装,但事实上并不仅仅只是如此,标准 I/O 会处理很多细节,譬如分配 stdio 缓冲区、以优化的块长度执行 I/O 等,这些处理使用户不必担心如何选择使用正确的块长度。I/O 库函数是构建于文件 I/O(open()、 read()、 write()、 lseek()、 close()等)这些系统调用之上的,譬如标准 I/O 库函数 fopen()就利用系统调用 open()来执行打开文件的操作、 fread()利用系统调用 read()来执行读文件操作、 fwrite()则利用系统调用 write()来执行写文件操作等等。那既然如此,为何还需要设计标准 I/O 库?直接使用文件 I/O 系统调用不是更好吗?事实上,并非如此, 在第一章中我们也提到过,设计库函数是为了提供比底层系统调用更为方便、好用的调用接口, 虽然标准 I/O 构建于文件 I/O 之上, 但标准 I/O 却有它自己的优势,标准 I/O 和文件 I/O 的区别如下:
虽然标准 I/O 和文件 I/O 都是 C 语言函数,但是标准 I/O 是标准 C 库函数,而文件 I/O 则是 Linux系统调用;
标准 I/O 是由文件 I/O 封装而来,标准 I/O 内部实际上是调用文件 I/O 来完成实际操作的;
-
可移植性:标准 I/O 相比于文件 I/O 具有更好的可移植性,通常对于不同的操作系统,其内核向应用层提供的系统调用往往都是不同,譬如系统调用的定义、功能、参数列表、返回值等往往都是不一样的;而对于标准 I/O 来说,由于很多操作系统都实现了标准 I/O 库,标准 I/O 库在不同的操作系统之间其接口定义几乎是一样的,所以标准 I/O 在不同操作系统之间相比于文件 I/O 具有更好的可移植性。
-
性能、效率: 标准 I/O 库在用户空间维护了自己的 stdio 缓冲区, 所以标准 I/O 是带有缓存的,而文件 I/O 在用户空间是不带有缓存的,所以在性能、效率上,标准 I/O 要优于文件 I/O。
对于标准 I/O 库函数来说,它们的操作是围绕 FILE 指针进行的,当使用标准 I/O 库函数打开或创建一个文件时,会返回一个指向 FILE 类型对象的指针(FILE *) ,使用该 FILE 指针与被打开或创建的文件相关联,然后该 FILE 指针就用于后续的标准 I/O 操作(使用标准 I/O 库函数进行 I/O 操作),所以由此可知,FILE 指针的作用相当于文件描述符,只不过 FILE 指针用于标准 I/O 库函数中、而文件描述符则用于文件I/O 系统调用中。FILE 是一个结构体数据类型,它包含了标准 I/O 库函数为管理文件所需要的所有信息,包括用于实际I/O 的文件描述符、指向文件缓冲区的指针、缓冲区的长度、当前缓冲区中的字节数以及出错标志等。 FILE数据结构定义在标准 I/O 库函数头文件 stdio.h 中。
所谓标准输入设备指的就是计算机系统的标准的输入设备,通常指的是计算机所连接的键盘;而标准输出设备指的是计算机系统中用于输出标准信息的设备,通常指的是计算机所连接的显示器;标准错误设备则指的是计算机系统中用于显示错误信息的设备,通常也指的是显示器设备。
用户通过标准输入设备与系统进行交互, 进程将从标准输入(stdin)文件中得到输入数据,将正常输出数据(譬如程序中 printf 打印输出的字符串) 输出到标准输出(stdout) 文件,而将错误信息(譬如函数调用报错打印的信息)输出到标准错误(stderr) 文件。标准输出文件和标准错误文件都对应终端的屏幕,而标准输入文件则对应于键盘。每个进程启动之后都会默认打开标准输入、标准输出以及标准错误, 得到三个文件描述符, 即 0、 1、2, 其中 0 代表标准输入、 1 代表标准输出、 2 代表标准错误;
在应用编程中可以使用宏 STDIN_FILENO、STDOUT_FILENO 和 STDERR_FILENO 分别代表 0、 1、 2,这些宏定义在 unistd.h 头文件中:
/* Standard file descriptors. */
#define STDIN_FILENO 0 /* Standard input. */
#define STDOUT_FILENO1 /* Standard output. */
#define STDERR_FILENO2 /* Standard error output. */
0、 1、 2 这三个是文件描述符,只能用于文件 I/O(read()、 write()等),那么在标准 I/O 中,自然是无法使用文件描述符来对文件进行 I/O 操作的,它们需要围绕 FILE 类型指针来进行,在 stdio.h 头文件中有相应的定义,如下:
/* Standard streams. */
extern struct _IO_FILE *stdin; /* Standard input stream. */
extern struct _IO_FILE *stdout; /* Standard output stream. */
extern struct _IO_FILE *stderr; /* Standard error output stream. */
/* C89/C99 say they're macros. Make them happy. */
#define stdin stdin
#define stdout stdou
t#define stderr stderr
Tips: struct _IO_FILE 结构体就是 FILE 结构体,使用了 typedef 进行了重命名。所以,在标准 I/O 中,可以使用 stdin、 stdout、 stderr 来表示标准输入、标准输出和标准错误。
用库函数fopen()打开或创建文件, fopen()函数原型如下所示:
#include <stdio.h>
FILE *fopen(const char *path, const char *mode);
使用该函数需要包含头文件 stdio.h。函数参数和返回值含义如下:
-
path: 参数 path 指向文件路径,可以是绝对路径、也可以是相对路径。
-
mode: 参数 mode 指定了对该文件的读写权限,是一个字符串,稍后介绍。
-
返回值: 调用成功返回一个指向 FILE 类型对象的指针(FILE *),该指针与打开或创建的文件相关联,后续的标准 I/O 操作将围绕 FILE 指针进行。 如果失败则返回 NULL,并设置 errno 以指示错误原因。参数 mode 字符串类型,可取值为如下值之一:
mode | 说明 | flags 参数取值 |
---|---|---|
r | 以只读方式打开文件。 | O_RDONLY |
r+ | 以可读、可写方式打开文件。 | O_RDWR |
w | 以只写方式打开文件;如果文件存在,将文件长度截断为0;如果文件不存在,则创建文件。 | `O_WRONLY |
w+ | 以可读、可写方式打开文件;如果文件存在,将文件长度截断为0;如果文件不存在,则创建文件。 | `O_RDWR |
a | 以只写方式打开文件,进行追加内容(在文件末尾写入);如果文件不存在,则创建文件。 | `O_WRONLY |
a+ | 以可读、可写方式打开文件,进行追加内容(在文件末尾写入);如果文件不存在,则创建文件。 | `O_RDWR |
读文件和写文件
当使用 fopen()库函数打开文件之后,接着我们便可以使用 fread()和 fwrite()库函数对文件进行读、写操作了,函数原型如下所示:
#include <stdio.h>
size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream);
size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);
库函数 fread()用于读取文件数据,其参数和返回值含义如下:
-
ptr: fread()将读取到的数据存放在参数 ptr 指向的缓冲区中;
-
size: fread()从文件读取 nmemb 个数据项,每一个数据项的大小为 size 个字节,所以总共读取的数据大小为 nmemb * size 个字节。
-
nmemb: 参数 nmemb 指定了读取数据项的个数。stream: FILE 指针。
-
返回值: 调用成功时返回读取到的数据项的数目(数据项数目并不等于实际读取的字节数,除非参数size 等于 1);如果发生错误或到达文件末尾,则 fread()返回的值将小于参数 nmemb,那么到底发生了错误还是到达了文件末尾, fread()不能区分文件结尾和错误, 究竟是哪一种情况,此时可以使用 ferror()或 feof()函数来判断
库函数 fwrite()用于将数据写入到文件中,其参数和返回值含义如下:
-
ptr: 将参数 ptr 指向的缓冲区中的数据写入到文件中。
-
size: 参数 size 指定了每个数据项的字节大小,与 fread()函数的 size 参数意义相同。
-
nmemb: 参数 nmemb 指定了写入的数据项个数,与 fread()函数的 nmemb 参数意义相同。stream: FILE 指针。
-
返回值: 调用成功时返回写入的数据项的数目(数据项数目并不等于实际写入的字节数,除非参数 size等于 1);如果发生错误,则 fwrite()返回的值将小于参数 nmemb(或者等于 0)。
由此可知,库函数 fread()、 fwrite()中指定读取或写入数据大小的方式与系统调用 read()、 write()不同,前者通过 nmemb(数据项个数) *size(每个数据项的大小)的方式来指定数据大小,而后者则直接通过一个 size 参数指定数据大小。譬如要将一个 struct mystr 结构体数据写入到文件中:
-
可按如下方式写入:fwrite(buf, sizeof(struct mystr), 1, file);
-
当然也可以按如下方式写:fwrite(buf, 1, sizeof(struct mystr), file);
库函数 fseek()的作用类似于系统调用 lseek(), 用于设置文件读写位置偏移量, lseek()用于文件 I/O,而库函数 fseek()则用于标准 I/O,其函数原型如下所示:
#include <stdio.h>int fseek(FILE *stream, long offset, int whence);
函数参数和返回值含义如下:
-
stream: FILE 指针。
-
offset: 与 lseek()函数的 offset 参数意义相同。
-
whence: 与 lseek()函数的 whence 参数意义相同。
-
返回值: 成功返回 0;发生错误将返回-1,并且会设置 errno 以指示错误原因; 与 lseek()函数的返回值意义不同,这里要注意!调用库函数 fread()、 fwrite()读写文件时,文件的读写位置偏移量会自动递增,使用 fseek()可手动设置文件当前的读写位置偏移量。
-
譬如将文件的读写位置移动到文件开头处:fseek(file, 0, SEEK_SET);
-
将文件的读写位置移动到文件末尾:fseek(file, 0, SEEK_END);
-
将文件的读写位置移动到 100 个字节偏移量处:fseek(file, 100, SEEK_SET);
调用 fread()读取数据时,如果返回值小于参数 nmemb 所指定的值,表示发生了错误或者已经到了文件末尾(文件结束 end-of-file),但 fread()无法具体确定是哪一种情况; 在这种情况下,可以通过判断错误标志或 end-of-file 标志来确定具体的情况。feof()函数库函数 feof()用于测试参数 stream 所指文件的 end-of-file 标志,如果 end-of-file 标志被设置了,则调用feof()函数将返回一个非零值,如果 end-of-file 标志没有被设置,则返回 0。
#include <stdio.h>
int feof(FILE *stream);
当文件的读写位置移动到了文件末尾时, end-of-file 标志将会被设置。库函数 ferror()用于测试参数 stream 所指文件的错误标志,如果错误标志被设置了,则调用 ferror()函数将返回一个非零值,如果错误标志没有被设置,则返回 0。其函数原型如下所示:
#include <stdio.h>
int ferror(FILE *stream);
C 库函数提供了 5 个格式化输出函数,包括: printf()、 fprintf()、 dprintf()、 sprintf()、 snprintf(),其函数定义如下所示:
#include <stdio.h>
int printf(const char *format, ...);
int fprintf(FILE *stream, const char *format, ...);
int dprintf(int fd, const char *format, ...);
int sprintf(char *buf, const char *format, ...);
int snprintf(char *buf, size_t size, const char *format, ...);
这 5 个函数都是可变参函数,它们都有一个共同的参数 format,这是一个字符串,称为格式控制字符串,用于指定后续的参数如何进行格式转换, 所以才把这些函数称为格式化输出,因为它们可以以调用者指定的格式进行转换输出; 学习这些函数的重点就是掌握这个格式控制字符串 format 的书写格式以及它们所代表的意义, 每个函数除了固定参数之外,还可携带 0 个或多个可变参数。printf()函数
用于将格式化数据写入到标准输出; dprintf()和 fprintf()函数用于将格式化数据写入到指定的文件中,两者不同之处在于, fprintf()使用 FILE 指针指定对应的文件、而 dprintf()则使用文件描述符 fd 指定对应的文件; sprintf()、 snprintf()函数可将格式化的数据存储在用户指定的缓冲区 buf 中。printf()函数前面章节内容编写的示例代码中多次使用了该函数,用于将程序中的字符串信息输出显示到终端(也就是标准输出),它是一个可变参函数,除了一个固定参数 format外,后面还可携带 0 个或多个参数。函数调用成功返回打印输出的字符数;失败将返回一个负值!打印"Hello World":printf("Hello World!\n");打印数字 5:printf("%d\n", 5);
fprintf()可将格式化数据写入到由 FILE 指针指定的文件中,譬如将字符串"Hello World"写入到标准错误:fprintf(stderr, "Hello World!\n");向标准错误写入数字 5:fprintf(stderr, "%d\n", 5);函数调用成功返回写入到文件中的字符数;失败将返回一个负值!
dprintf()可将格式化数据写入到由文件描述符 fd 指定的文件中,譬如将字符串"Hello World"写入到标准错误:dprintf(STDERR_FILENO, "Hello World!\n");向标准错误写入数字 5:dprintf(STDERR_FILENO, "%d\n", 5);函数调用成功返回写入到文件中的字符数;失败将返回一个负值!
sprintf()函数:sprintf()函数将格式化数据存储在由参数 buf 所指定的缓冲区中, 譬如将字符串"Hello World"存放在缓冲区中:
char buf[100];sprintf(buf, "Hello World!\n");
当然这种用法并没有意义,事实上,我们一般会使用这个函数进行格式化转换,并将转换后的字符串存放在缓冲区中,譬如将数字 100 转换为字符串"100",将转换后得到的字符串存放在 buf 中:
char buf[20] = {0};
sprintf(buf, "%d", 100);
sprintf()函数会在字符串尾端自动加上一个字符串终止字符'\0'。
需要注意的是, sprintf()函数可能会造成由参数 buf 指定的缓冲区溢出,调用者有责任确保该缓冲区足够大,因为缓冲区溢出会造成程序不稳定甚至安全隐患!函数调用成功返回写入到 buf 中的字节数;失败将返回一个负值!snprintf()函数sprintf()函数可能会发生缓冲区溢出的问题,存在安全隐患,为了解决这个问题,引入了 snprintf()函数;在该函数中,使用参数 size 显式的指定缓冲区的大小,如果写入到缓冲区的字节数大于参数 size 指定的大小,超出的部分将会被丢弃!如果缓冲区空间足够大, snprintf()函数就会返回写入到缓冲区的字符数,与sprintf()函数相同,也会在字符串末尾自动添加终止字符'\0'。若发生错误, snprintf()将返回一个负值!
以上 5 个函数中的 format 参数应该怎么写,把这个参数称为格式控制字符串,顾名思义,首先它是一个字符串的形式,其次它能够控制后续变参的格式转换。格式控制字符串由两部分组成:普通字符(非%字符) 和转换说明。普通字符会进行原样输出,每个转换说明都会对应后续的一个参数,通常有几个转换说明就需要提供几个参数(除固定参数之外的参数), 使之一一对应,用于控制对应的参数如何进行转换。如下所示:printf("转换说明 1 转换说明 2 转换说明 3", arg1, arg2, arg3);这里只是以 printf()函数举个例子,实际上并不这样用。三个转换说明与参数进行一一对应,按照顺序方式一一对应。每个转换说明都是以%字符开头,其格式如下所示(使用[ ]括起来的部分是可选的) :
%[flags][width][.precision][length]type
-
flags: 标志,可包含 0 个或多个标志;
-
width: 输出最小宽度,表示转换后输出字符串的最小宽度;precision: 精度,前面有一个点号" . ";
-
length: 长度修饰符;
-
type: 转换类型,指定待转换数据的类型。
-
可以看到,只有%和 type 字段是必须的,其余都是可选的。
首先说明 type(类型), 因为类型是格式控制字符串的重中之重,是必不可少的组成部分,其它的字段都是可选的, type 用于指定输出数据的类型, type 字段使用一个字符(字母字符)来表示:
字符 | 对应数据类型 | 含义 | 示例说明 |
---|---|---|---|
d/i | int | 输出有符号十进制表示的整数,i 是老式写法 |
printf("%d\n", 123); 输出: 123 |
o | unsigned int | 输出无符号八进制表示的整数(默认不输出前缀0,可在 # 标志下输出前缀0) |
printf("%o\n", 123); 输出: 173 |
u | unsigned int | 输出无符号十进制表示的整数 | printf("%u\n", 123); 输出: 123 |
x/X | unsigned int | 输出无符号十六进制表示的整数,x 和 X 区别在于字母大小写 |
printf("%x\n", 123); 输出: 7b printf("%X\n", 123); 输出: 7B |
f/F | double | 输出浮点数,f 和 F 区别在于字母大小写,默认保留小数点后 6 位数 |
printf("%f\n", 520.1314); 输出: 520.131400 printf("%F\n", 520.1314); 输出: 520.131400 |
e/E | double | 输出以科学计数法表示的浮点数,e 和 E 区别在于字母大小写 |
printf("%e\n", 520.1314); 输出: 5.201314e+02 printf("%E\n", 520.1314); 输出: 5.201314E+02 |
g | double | 根据数值的长度,选择以最短方式输出,%f/%e | printf("%g %g\n", 0.000000123, 0.123); 输出: 1.23e-07 0.123 |
G | double | 根据数值的长度,选择以最短方式输出,%F/%E | printf("%G %G\n", 0.000000123, 0.123); 输出: 1.23E-07 0.123 |
s | char * | 字符串,输出字符串中的字符直到终止字符 \0 |
printf("%s\n", "Hello World"); 输出: Hello World |
p | void * | 输出十六进制表示的指针 | printf("%p\n", "Hello World"); 输出: 0x400624 |
c | char | 字符型,将输入的数字转换为对应的 ASCII 字符输出 | printf("%c\n", 64); 输出: A |
flags字段的含义如下:
字符 | 名称 | 作用 |
---|---|---|
# |
井号 | 对于 o 类型,输出字符串增加前缀 0;对于 x 或 X 类型,输出前缀 0x 或 0X 。对于浮点数类型,强制输出小数点。 |
0 |
数字 0 | 当输出数字(非 c 或 s 类型)时,在输出前补 0,直到达到指定最小宽度。 |
- |
减号 | 左对齐输出,若宽度不足则在右边填充空格。若同时指定 0 和 - ,- 会覆盖 0 。 |
' ' |
空格 | 输出正数时,在数字前加一个空格,负数则加负号 - 。 |
+ |
加号 | 输出时无论正数还是负数,前面都带符号。正数带 + ,负数带 - 。+ 会覆盖 ' ' (空格)。 |
宽度类型 | 描述 | 示例 |
---|---|---|
数字 |
指定输出的最小宽度,若实际输出位数小于指定宽度,前面会补充空格或 0 。 |
printf("%06d", 1000); 输出: 001000 |
* |
不显示宽度数值,宽度由参数列表中的值指定。 | printf("%0*d", 6, 1000); 输出: 001000 |
描述 | 类型 | 示例 |
---|---|---|
数字 | 整型(d , i , o , u , x , X ) |
对于整型,指定输出的最小数字位数,不足时补前导零。 例如 printf("%8.5d", 100); 输出: 00100 |
浮点型(a , A , e , E , f , F ) |
对于浮点数,指定小数点后数字的个数。默认6位。 例如 printf("%.8f", 520.1314); 输出: 520.13140000 |
|
g , G |
对于 g 和 G ,表示最大有效数字位数。 |
|
字符串 | s |
指定最大输出字符数,超过则截断。 例如 printf("%.5s", "hello world"); 输出: hello |
* |
星号 | 精度由参数列表指定,例如 printf("%.*s", 5, "hello world"); 输出: hello |
长度修饰符指明待转换数据的长度,因为 type 字段指定的的类型只有 int、unsigned int 以及 double 等几种数据类型,但是C 语言内置的数据类型不止这几种,譬如有 16bit 的 short、unsigned short,8bit 的char、unsigned char,也有64bit 的 long long 等,为了能够区别不同长度的数据类型,于是乎,长度修饰符(length)应运而生,成为转换说明的一部分。 length 长度修饰符也是使用字符(字母字符)来表示,结合type 字段以确定不同长度的数据类型:
type | length | 描述 |
---|---|---|
d , i |
none |
int 类型,输出有符号十进制整数。 |
u , o , x , X |
none |
unsigned int 类型,输出无符号十进制、八进制、十六进制整数。 |
f , F , e , E , g , G |
none |
double 类型,输出浮点数,使用小数表示或科学计数法。 |
c |
none |
char 类型,输出一个字符。 |
s |
none |
char * 类型,输出字符串。 |
p |
none |
void * 类型,输出指针的十六进制表示。 |
hh |
signed char , unsigned char |
signed char 或 unsigned char 类型,输出字符。 |
h |
short int , unsigned short int |
short int 或 unsigned short int 类型,输出整数。 |
l |
long int , unsigned long int |
long int 或 unsigned long int 类型,输出整数。 |
wint_t |
wchar_t |
宽字符类型(wint_t 或 wchar_t ),用于宽字符处理。 |
ll |
long long int , unsigned long long int |
long long int 或 unsigned long long int 类型,输出整数。 |
L |
long double |
long double 类型,输出浮点数。 |
j |
intmax_t , uintmax_t |
intmax_t 或 uintmax_t 类型,输出整数。 |
z |
size_t , ssize_t |
size_t 或 ssize_t 类型,输出无符号或有符号整数。 |
t |
ptrdiff_t |
ptrdiff_t 类型,表示指针差值。 |
格式化输入是类似的,这里不加以赘述了。