C语言文件操作

目录

1.为什么使用文件

2.什么是文件

2.1程序文件

2.2 数据文件

2.3文件名

3文件的打开和关闭

3.1文件指针

3.2文件的打开和关闭

4.文件的顺序读写

4.1对比一组函数

5.文件的随机读写

5.1fseek

5.2ftell

5.3rewind

6.文本文件和二进制文件

7.文件读取结束的判定

7.1被错误使用的feof

8.文件缓冲区

1.为什么使用文件

我们前面学习结构体时，写了通讯录的程序，当通讯录运行起来的时候，可以给通讯录中增加、删除数据，此时数据是存放在内存中，当程序退出的时候，通讯录中的数据自然就不存在了，等下次运行通讯录程序的时候，数据又得重新录入，如果使用这样的通讯录就很难受。

我们在想既然是通讯录就应该把信息记录下来，只有我们自己选择删除数据的时候，数据才不复存在。这就涉及到了数据持久化的问题，我们一般数据持久化的方法有，把数据存放在磁盘文件、存放到数据库等方式。

使用文件我们可以将数据直接存放在电脑的硬盘上，做到了数据的持久化

2.什么是文件

磁盘上的文件是文件，但是在程序设计中，我们一般谈的文件有两种：程序文件、数据文件（从文件功能的角度来分类的）。

2.1程序文件

包括源程序文件（后缀为.c），目标文件（Windows环境后缀为.obj），可执行程序（Windows环境后缀为.exe）。

2.2 数据文件

文件的内容不一定是程序，而是程序运行时读写的数据，比如程序运行需要从中读取数据的文件，

或者输出内容的文件。

现在讨论的是数据文件，在以前学习所处理数据的输入输出都是以终端为对象的，即从终端的键盘输入数据，运行结果显示到显示器上。

其实有时候我们会把信息输出到磁盘上，当需要的时候再从磁盘上把数据读取到内存中使用，这里处理的就是磁盘上文件。

2.3文件名

一个文件要有一个唯一的文件标识，以便用户识别和引用。

文件名包含3部分：文件路径+文件名主干+文件后缀

例如： c:\code\test.txt，文件名主干就是文件的名字test。

为了方便起见，文件标识常被称为文件名。

3文件的打开和关闭

3.1文件指针

缓冲文件系统中，关键的概念是“文件类型指针”，简称“文件指针”。

每个被使用的文件都在内存中开辟了一个相应的文件信息区，用来存放文件的相关信息（如文件的名字，文件状态及文件当前的位置等）。这些信息是保存在一个结构体变量中的。该结构体类型是有系统声明的，取名FILE.

例如，VS2013编译环境提供的 stdio.h 头文件中有以下的文件类型申明：

struct _iobuf {
char *_ptr;
int _cnt;
char *_base;
int _flag;
int _file;
int _charbuf;
int _bufsiz;
char *_tmpfname;
};
typedef struct _iobuf FILE;

不同的C编译器的FILE类型包含的内容不完全相同，但是大同小异。

每当打开一个文件的时候，系统会根据文件的情况自动创建一个FILE结构的变量，并填充其中的信息，使用者不必关心细节。

一般都是通过一个FILE的指针来维护这个FILE结构的变量，这样使用起来更加方便。

下面我们可以创建一个FILE*的指针变量:

FILE* pf;//文件指针变量

定义pf是一个指向FILE类型数据的指针变量。可以使pf指向某个文件的文件信息区（是一个结构体变量）。通过该文件信息区中的信息就能够访问该文件。也就是说，通过文件指针变量能够找到与它关联的文件。

3.2文件的打开和关闭

文件在读写之前应该先打开文件，在使用结束之后应该关闭文件。

在编写程序的时候，在打开文件的同时，都会返回一个FILE*的指针变量指向该文件，也相当于建立了指针和文件的关系。

ANSIC 规定使用fopen函数来打开文件，fclose来关闭文件。

//打开文件
FILE * fopen ( const char * filename, const char * mode );
//关闭文件
int fclose ( FILE * stream );

打开文件的方式如下：

文件使用方式	含义	如果指定文件不存在
“r”（只写）	为了输入数据，打开一个已经存在的文本文件	出错
“w”（只写）	为了输出数据，打开一个文本文件	建立一个新的文件
“a”（追加）	向文本文件尾添加数据	建立一个新的文件
“rb”（只读）	为了输入数据，打开一个二进制文件	出错
“wb”（只写）	为了输出数据，打开一个二进制文件	建立一个新的文件
“ab”（追加）	向一个二进制文件尾添加数据	出错
“r+”（读写）	为了读和写，打开一个文本文件	出错
“w+”（读写）	为了读和写，建议一个新的文件	建立一个新的文件
“a+”（读写）	打开一个文件，在文件尾进行读写	建立一个新的文件
“rb+”（读写）	为了读和写打开一个二进制文件	出错
“wb+”（读写）	为了读和写，新建一个新的二进制文件	建立一个新的文件
“ab+”（读写）	打开一个二进制文件，在文件尾进行读和写	建立一个新的文件

代码：

int main()
{
    //D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt - 这种是绝对路径
    //test.txt - 这种是相对路径，相对路径就是只有文件名加后缀，没有文件路径
    //./当前目录，../是上一级目录，../../test.txt是上一级目录的上一级目录
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "r");
    //如果这个路径底下有test.txt这个文件则打开成功，如果没有则打开失败
    if (pf == NULL)
    {
        perror("fopen");//打印错误信息
        return 1;
    }
    else
    {
        printf("打开文件成功\n");
    }
    //文件操作：读文件过程
    //......

    //关闭文件
    fclose(pf);//和free函数一样不会把指针置为NULL，需要主动置为NULL。
    pf = NULL;

    return 0;
}

打开前：

打开后：

当再去打开test.txt文件时内容已被清空。

注：带有w的形式打开一个相同名字加相同后缀的文件会把原有的文件覆盖掉

4.文件的顺序读写

功能	函数名	适用于
字符输入函数	fgetc	所有输入流 / 读
字符输出函数	fputc	所有输出流 / 写
文本行输入函数	fgets	所有输入流 / 读
文本行输出函数	fputs	所有输出流 / 写
格式化输入函数	fscanf	所有输入流 / 读
格式化输出函数	fprintf	所有输出流 / 写
二进制输入	fread	文件 / 读
二进制输出	fwrite	文件 / 写

fputc

fputc函数一次往文件里面写入一个字符，成功后，将返回所写字符ASCII码值。
如果发生写入错误，则返回EOF并设置错误指示器（ferror）。

int main()
{
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "w");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //写文件
    //fputa函数一次只往文件里面写入一个字符
    //fputa('a', pf);
    //fputa('b', pf);
    //fputa('c', pf);
    //fputa('d', pf);

    char ch = 0;
    for (ch = 'a'; ch <= 'z'; ch++)
    {
        fputc(ch, pf);
    }

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fgetc

fgetc函数一次只在文件里面读取一个字符，成功后，将返回字符读取（提升为 int 值）。

返回类型为 int 以适应特殊值 EOF，该值表示失败：

如果位置指示器位于文件末尾，则该函数返回 EOF 并设置流的 eof 指示器 （feof）。

如果发生其他读取错误，该函数还会返回 EOF，但改为设置其错误指示器 （ferror）。

int main()
{
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "r");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //读文件
    char ch = 0;
    //fgetc函数一次只在文件里面读取一个字符
    for (ch = 'a'; ch <= 'z'; ch++)
    {
        ch = fgetc(pf);
        printf("%c", ch);
    }

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fputs

一次写入一行字符串

int main()
{
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "w");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //写文件
    fputs("hello world\n", pf);
    fputs("hello bit\n", pf);

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fgets

一次写读取一行字符串。

为什么才读取4个字符？我们不应该读取的是五个字符吗？实际上却是读入了五个字符，这个函数会主动在后面追加一个\0。

一次无法读取换行的字符串。

int main()
{
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "r");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    char ch[20] = { 0 };
    //读文件
    fgets(ch, 20, pf);
    printf("%s", ch);
    fgets(ch, 20, pf);
    printf("%s", ch);


    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fpringf

格式化输出函数

struct S
{
    char name[20];
    int age;
    double score;
};

int main()
{
    struct S s = { "张三", 20, 95.5 };
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "w");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //格式化的写入文件
    fprintf(pf, "%s %d %.1lf\n", s.name, s.age, s.score);

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fscanf

格式化输入函数

struct S
{
    char name[20];
    int age;
    double score;
};

int main()
{
    struct S s = { 0 };
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "r");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //格式化的读取文件
    fscanf(pf, "%s %d %lf\n", s.name, &(s.age), &(s.score));
    //打印看数据
    printf("%s %d %.1lf\n", s.name, s.age, s.score);
    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fwrite

二进制输出

注：第三个参数是元素个数

因为是以二进制的形式写入的并不是我们的代码写错了。

struct S
{
    char name[20];
    int age;
    double score;
};

int main()
{
    struct S s = { "张三", 20, 95.5 };
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "wb");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //以二进制形式写入文件
    fwrite(&s, sizeof(struct S), 1, pf);

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

fread

二进制输入

注：第三个参数是元素个数

struct S
{
    char name[20];
    int age;
    double score;
};

int main()
{
    struct S s = { 0 };
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "rb");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    //以二进制形式读取文件
    fread(&s, sizeof(struct S), 1, pf);
    printf("%s %d %lf", s.name, s.age, s.score);

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

4.1对比一组函数

scanf/fscanf/sscanf

printf/fprintf/sprintf

我们在写C程序时经常遇到printf（），fprintf（），perror（），这些东西到底有什么作用。说到这不得不提及stdin，stdout，stderr。想想，我们在用C去写文件时的操作，File* fp = fopen()，这个fp就是我们向系统申请的，相当于一通往文件的通道。

其实，stdin, stdout, stderr就是这个fp，不过他是随着计算机系统的开启默认打开的，其中0就是stdin，表示输入流，指从键盘输入，1代表stdout，2代表stderr，1, 2默认是显示器。

sprintf

sscanf

5.文件的随机读写

5.1fseek

根据文件指针的位置和偏移量来定位文件指针。

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

假设test.txt这个文件里面有abcdef这几个字符，我们要从不同的位置去读取b字符。

5.2ftell

返回文件指针相当于起始位置的偏移量。

long int ftell ( FILE * stream );

int main()
{
    FILE* pf = fopen("test.txt", "r");
    if (pf == NULL)
    {
        perror("fopen");
    }
    else
    {
        int ch = fgetc(pf);
        printf("%c\n", ch);//a
        ch = fgetc(pf);
        printf("%c\n", ch);//b
        ch = fgetc(pf);
        printf("%c\n", ch);//c

        //如果继续往下读，必然是d
        //但是我们调整一下，去读取：b
        fseek(pf, -2, SEEK_CUR);//从当前位置向后偏移2
        ch = fgetc(pf);
        printf("%c\n", ch);
        fseek(pf, 1, SEEK_SET);//从头开始向前偏移一个位置1
        ch = fgetc(pf);
        printf("%c\n", ch);

        printf("%d\n", ftell(pf));
    }
    //关闭文件
    fclose(pf);
    pf = NULL;
    return 0;
}

5.3rewind

void rewind ( FILE * stream );

让文件指针的位置回到文件的起始位置。

虽然我们也可以直接使用fseek函数让文件指针回到起始位置列如：

fseek（pf, 0, SEEK_SET);

但是这样还是比较麻烦的，不如直接使用rewind

int main()
{
    FILE* pf = fopen("test.txt", "r");
    if (pf == NULL)
    {
        perror("fopen");
    }
    else
    {
        int ch = fgetc(pf);
        printf("%c\n", ch);//a
        ch = fgetc(pf);
        printf("%c\n", ch);//b
        ch = fgetc(pf);
        printf("%c\n", ch);//c

        //如果继续往下读，必然是d
        //但是我们调整一下，去读取：b
        fseek(pf, 1, SEEK_SET);//从头开始向前偏移一个位置1
        ch = fgetc(pf);
        printf("%c\n", ch);

        printf("%d\n", ftell(pf));//获取文件指针当前位置

        rewind(pf);//让文件指针回到开头
        ch = fgetc(pf);
        printf("%c\n", ch);
    }

    //关闭文件
    fclose(pf);
    pf = NULL;
    return 0;
}

6.文本文件和二进制文件

根据数据的组织形式，数据文件被称为文本文件或者二进制文件。

数据在内存中以二进制的形式存储，如果不加转换的输出到外存，就是二进制文件。

如果要求在外存上以ASCII码的形式存储，则需要在存储前转换。以ASCII字符的形式存储的文件就是文本文件。

一个数据在内存中是怎么存储的呢？

字符一律以ASCII形式存储，数值型数据既可以用ASCII形式存储，也可以使用二进制形式存储。

如有整数10000，如果以ASCII码的形式输出到磁盘，则磁盘中占用5个字节（每个字符一个字节），而二进制形式输出，则在磁盘上只占4个字节（VS2022测试）。

测试代码：

int main()
{
    //打开文件
    FILE* pf = fopen("D:\\code\\1.14\\test_1_14\\test_1_14\\test.txt", "wb");
    if (pf == NULL)
    {
        perror("fopen::");
        return 1;
    }

    int a = 10000;
    //以格式化输出
    //fprintf(pf, "%d", a);
    //以二进制输出
    fwrite(&a, 4, 1, pf);//二进制的形式写到文件中

    //关闭文件
    fclose(pf);
    pf = NULL;

    return 0;
}

7.文件读取结束的判定

7.1被错误使用的feof

牢记：在文件读取过程中，不能用feof函数的返回值直接用来判断文件的是否结束。

而是应用于当文件读取结束的时候，判断是读取失败结束，还是遇到文件尾结束。

1、文本文件读取是否结束，判断返回值是否为 EOF （ fgetc ），或者 NULL （ fgets ）

列如这两个函数：

fgetc 判断是否为 EOF
fgets 判断返回值是否为 NULL

.......

2、二进制文件的读取结束判断，判断返回值是否小于实际要读的个数。

fread 判断返回值是否小于实际要读的个数。

正确的使用：

int main()
{
    int c; // 注意：int，非char，要求处理EOF
    FILE* fp = fopen("test.txt", "r");
    if (!fp) {
        perror("File opening failed");
        return EXIT_FAILURE;
    }
    //fgetc 当读取失败的时候或者遇到文件结束的时候，都会返回EOF
    while ((c = fgetc(fp)) != EOF) // 标准C I/O读取文件循环
    {
        putchar(c);
    }
    //判断是什么原因结束的
    if (ferror(fp))
        puts("I/O error when reading");//
    else if (feof(fp))
        puts("End of file reached successfully");
    fclose(fp);
    
    return 0;
}

首先我们需要去读取一个文件，当读取文件结束时，我们想知道它读取结束的原因，是正常读取遇到了结束标志而结束还是读取过程出现错误而结束？使用以下这两个函数就可以就知道结束原因：

feof 函数 - 判断返回真，就说明是文件正常读取遇到了结束标志而结束。

ferror 函数 - 判断返回真，就说明是文件在读取过程中出错了，而结束。

二进制文件的例子

enum { SIZE = 5 };
int main(void)
{
    //写文件
    double a[SIZE] = { 1.,2.,3.,4.,5. };
    FILE* fp = fopen("test.bin", "wb"); // 必须用二进制模式
    fwrite(a, sizeof * a, SIZE, fp); // 写 double 的数组
    fclose(fp);

    //读文件
    double b[SIZE];
    fp = fopen("test.bin", "rb");
    size_t ret_code = fread(b, sizeof * b, SIZE, fp); // 读 double 的数组
    if (ret_code == SIZE) {
        puts("Array read successfully, contents: ");
        for (int n = 0; n < SIZE; ++n) printf("%f ", b[n]);
        putchar('\n');
    }
    else { // error handling
        if (feof(fp))
            printf("Error reading test.bin: unexpected end of file\n");
        else if (ferror(fp)) {
            perror("Error reading test.bin");
        }
    }
    fclose(fp);

    return 0;
}

8.文件缓冲区

ANSIC 标准采用“缓冲文件系统”处理的数据文件的，所谓缓冲文件系统是指系统自动地在内存中为程序中每一个正在使用的文件开辟一块“文件缓冲区”。从内存向磁盘输出数据会先送到内存中的缓冲区，装满缓冲区后才一起送到磁盘上。如果从磁盘向计算机读入数据，则从磁盘文件中读取数据输入到内存缓冲区（充满缓冲区），然后再从缓冲区逐个地将数据送到程序数据区（程序变量等）。缓冲区的大小根据C编译系统决定的。

#include <stdio.h>
#include <windows.h>
int main()
{
    FILE* pf = fopen("test.txt", "w");
    fputs("abcdef", pf);//先将代码放在输出缓冲区
    printf("睡眠10秒-已经写数据了，打开test.txt文件，发现文件没有内容\n");
    Sleep(10000);
    printf("刷新缓冲区\n");
    fflush(pf);//刷新缓冲区时，才将输出缓冲区的数据写到文件（磁盘）
    //注：fflush 在高版本的VS上不能使用了
    printf("再睡眠10秒-此时，再次打开test.txt文件，文件有内容了\n");
    Sleep(10000);
    fclose(pf);
    //注：fclose在关闭文件的时候，也会刷新缓冲区
    pf = NULL;
    return 0;
}

fflush 函数 - 主动刷新缓冲区

fclose - 关闭文件的时候，也会刷新缓冲区。

因为有缓冲区的存在，C语言在操作文件的时候，需要做刷新缓冲区或者在文件操作结束的时候关闭文件。如果不做，可能导致读写文件的问题。（注：文件缓冲区的大小是可以修改的）