C语言文件操作

打开文件fopen

我们可以使用fopen()创建一个新的或者打开一个文件, 文件信息会保存在一个FILE类型的指针中, 该函数的原型为:

FILE *fopen( const char * filename, const char * mode );

filename是文件名, mode是打开模式, 可选值如下:

r  - 以只读方式打开一个文件, 该文件必须存在w  - 以只写方式打开一个文件, 文件不存在会创建新的文件, 文件存在会首先清空原有内容a  - 以追加的方式写文件, 文件不存在会创建新的文件, 文件存在从文件尾开始写文件r+ - 以读写方式打开文件, 文件不存在不会创建新的文件(r+在写时并不清空已有的内容, 但是会从文件开头开始写, 写入的内容会覆盖已有内容.)w+ - 以读写方式打开文件, 文件不存在会创建新的文件, 文件存在会首先清空原有内容a+ - 以追加方式读写文件, 文件不存在会创建新的文件, 文件存在从文件尾开始写文件

如果是操作二进制文件, 那么需要在mode里加上b, 如下所示:

"rb", "wb", "ab", "rb+", "r+b", "wb+", "w+b", "ab+", "a+b"

文件成功打开会返回一个FILE类型的指针, 如果打开失败, 会返回一个空指针(NULL), 并把错误代码存在errno中.

关闭文件fclose

我们可以使用fclose来关闭文件, 函数原型为:

int fclose( FILE *fp );

如果fclose执行成功, 会返回0, 如果执行出错则会返回EOF(在stdio.h中定义). 当fclose关闭文件时, 会首先将输出流(output) buffer 中的内容写入到文件, 将输入流(input) buffer 中的内容丢弃, 然后关闭文件, 释放其对应的内存.

写文件

fputc

将一个字符写入到fp所指向的输出流中(不只是文件输出流), 写入成功会返回写入的字符, 写入失败会返回EOF, 函数原型为：

int fputc( char c, FILE *fp );

void test_fputc() {    FILE *fp;    fp = fopen("test.txt", "w+");    int num;    for(char c = 'A'; c <= 'Z'; c++) {        num = fputc(c, fp);        printf("num is %d\n", num);    }    fclose(fp);}

test.txt中的内容为：

ABCDEFGHIJKLMNOPQRSTUVWXYZ

fputs

fputs从指定的地址(str)开始复制, 直到遇到标志结束的字符’\0’, 同时’\0’不会被复制到输出流中. 如果函数执行成功会返回一个非负整数, 否则返回EOF, 该函数的原型为:

int fputs ( const char * str, FILE * stream );

void test_fputs() {    FILE *fp;    fp = fopen("test.txt", "w+");    char *c = "this is a test...\n";    char c1[6] = {'A', 'B', 'C', '\0', 'E', 'F'};    int num;    num = fputs(c, fp);    printf("num is %d\n", num);    num = fputs(c1, fp);    printf("num is %d\n", num);    fclose(fp);}

执行完test_fputs, test.txt中的内容如下所示, 注意c1只写入了ABC

this is a test...ABC

fprintf

fprintf用来将格式化数据输出到输出流, 和printf用法相同, 下面是函数原型:

int fprintf ( FILE * stream, const char * format, ... );

void test_fprintf() {    FILE *fp;    fp = fopen("test.txt", "w+");    int num;    int i = 100;    num = fprintf(fp, "this is a test...\n");    printf("num is %d\n", num);    num = fprintf(fp, "i is %d and address of i is %p", i, &i);    printf("num is %d\n", num);    fclose(fp);}

执行test_fprintf后, test.txt中的内容为:

this is a test...i is 100 and address of i is 0x7ffd32721f90

读文件

fgetc

fgetc一次读取一个字符, 同时将文件指针往后移一个字符, 如果读取成功会返回读取的字符, 出现错误会返回EOF. 当读到文件末尾时, 也会返回EOF, 并且在输出流中设置文件结束标志(end-of-file indicator). 下面是该函数的原型:

int fgetc ( FILE * stream );

下面是一个使用示例, 其中test.txt中的内容为this is a test…

void test_fgetc() {    FILE *fp;    fp = fopen("test.txt", "r");    int i, n = 20;    char c;    for(i = 0; i < 20; i++) {        c = fgetc(fp);        printf("%c",c);    }    printf("\n");    fclose(fp);}

输出结果为:

this is a test...

fgets

该函数的原型为:

char * fgets ( char * str, int num, FILE * stream );

fgets从stream中读取内容到str, 当满足下面任意一个条件时完成读取操作:
- 读取了num-1个字符
- 读到了换行符(newline character)
- 读到了文件结尾(end-of-file)
注意第二条, 换行符也会被读到str中. 读取完成后会在str后面追加上终止字符’\0’, 这也是第一条为什么只读 num-1 个字符的原因. 函数返回值是一个指向str的指针.

void test_fgets() {    FILE *fp;    fp = fopen("test.txt", "r");    char c[50];    fgets(c, 5, fp);    printf("c is '%s'\n", c);    printf("c length is %ld\n", strlen(c));    // 重置文件指针到文件开头    rewind(fp);    fgets(c, 20, fp);    printf("c is '%s'\n", c);    printf("c length is %ld\n", strlen(c));    fclose(fp);

其中test.txt中内容为:

this is a test...this is a test...this is a test...

执行结果为:

c is 'this'c length is 4c is 'this is a test...'c length is 18

fscanf

fscanf以格式化的形式读入数据, 函数原型如下:

int fscanf ( FILE * stream, const char * format, ... );

fscanf以空格和换行符作为读入的结束字符, 同时在fscanf读入时会忽略第一个非空字符前面的空白符(空格,换行,tab), 下面是一个测试示例

void test_scanf() {    FILE *fp;    fp = fopen("test.txt", "r");    int num[3], i;    for(i = 0; i < 3; i++) {        num[i] = 0;    }    fscanf(fp, "%d%d", num, num+1);    for(i = 0; i < 3; i++) {        printf("num[%d] is %d\n", i, num[i]);    }    fclose(fp);}

其中test.txt中的内容为:

10     55dddd

程序执行结果为:

num[0] is 10num[1] is 55num[2] is 0

在test.txt中 10 前面有个空行, 55 前面有多个空格, 并且后面有 dddd等非数字字符, fscanf在读入时会忽略掉前面的空白符, 并且执行到不匹配的地方就不再往后读入.

fseek()函数

fseek()用来移动文件流的读写位置. 函数原型：

int fseek(FILE * stream, long offset, int whence);

1. 参数stream 为已打开的文件指针,
2. 参数offset 为根据参数whence 来移动读写位置的位移数。
3. 参数 whence 为下列其中一种:
   SEEK_SET 从距文件开头offset 位移量为新的读写位置.
   SEEK_CUR 以目前的读写位置往后增加offset 个位移量.
   SEEK_END 将读写位置指向文件尾后再增加offset 个位移量.
   当whence 值为SEEK_CUR 或 SEEK_END 时, 参数offset 允许负值的出现.

下列是较特别的使用方式：
1. 欲将读写位置移动到文件开头时:fseek(FILE *stream, 0, SEEK_SET);
2. 欲将读写位置移动到文件尾时:fseek(FILE *stream, 0, 0SEEK_END);

返回值：当调用成功时则返回0, 若有错误则返回-1, errno 会存放错误代码.

对于以二进制方式打开的文件流，移动后的位置为 wherece + offset。
对于以文本方式打开的文件流，offset 必须为 0 或 ftell() 函数的返回值，而且 wherece 必须为 SEEK_SET。
ftell函数是用来获取文件的当前读写位置;
函数原型: long ftell(FILE *fp)
函数功能:得到流式文件的当前读写位置,其返回值是当前读写位置偏离文件头部的字节数.

二进制文件的读写在另外一篇博客里面已经介绍过了，在此不赘述。