c语言文件操作 fopen、fwrite、fread、fclose、fgets、fputs

1、fopen
描述：
C 库函数 FILE *fopen(const char *filename, const char *mode) 使用给定的模式 mode 打开 filename 所指向的文件。
声明：

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

参数：
filename – 这是 C 字符串，包含了要打开的文件名称。
mode – 这是 C 字符串，包含了文件访问模式，模式如下：
模式 描述
“r” 打开一个用于读取的文件。该文件必须存在。
“w” 创建一个用于写入的空文件。如果文件名称与已存在的文件相同，则会删除已有文件的内容，文件被视为一个新的空文件。
“a” 追加到一个文件。写操作向文件末尾追加数据。如果文件不存在，则创建文件。
“r+” 打开一个用于更新的文件，可读取也可写入。该文件必须存在。
“w+” 创建一个用于读写的空文件。
“a+” 打开一个用于读取和追加的文件。
“rt”　　只读打开一个文本文件，只允许读数据
“wt”　只写打开或建立一个文本文件，只允许写数据
“at”　追加打开一个文本文件，并在文件末尾写数据
“rb”　只读打开一个二进制文件，只允许读数据
“wb” 只写打开或建立一个二进制文件，只允许写数据
“ab” 　追加打开一个二进制文件，并在文件末尾写数据
“rt+”　读写打开一个文本文件，允许读和写
“wt+”　读写打开或建立一个文本文件，允许读写
“at+”　读写打开一个文本文件，允许读，或在文件末追加数据
“rb+”　读写打开一个二进制文件，允许读和写
“wb+”　读写打开或建立一个二进制文件，允许读和写
“ab+” 读写打开一个二进制文件，允许读，或在文件末追加数据

对于文件使用方式有以下几点说明：
　　1. 文件使用方式由r,w,a,t,b，+六个字符拼成，各字符的含义是：
　　r(read): 读
　　w(write): 写
　　a(append): 追加
　　t(text): 文本文件，可省略不写
　　b(banary): 二进制文件
　　+: 读和写
　　2. 凡用“r”打开一个文件时，该文件必须已经存在，且只能从该文件读出。
　　3. 用“w”打开的文件只能向该文件写入。若打开的文件不存在，则以指定的文件名建立该文件，若打开的文件已经存在，则将该文件删去，重建一个新文件。
　　4. 若要向一个文件追加新的信息，用“a ”方式打开文件。文件可存在可不存在，若不存在会自动创建。
　　5. 在打开一个文件时，如果出错，fopen将返回一个空指针值NULL。在程序中可以用这一信息来判别是否完成打开文件的工作，并作相应的处理。如果成功的打开一个文件, fopen()函数返回文件指针, 否则返回空指针(NULL)。由此可判断文件打开是否成功。 fclose()函数用来关闭一个由fopen()函数打开的文件 , 其调用格式为:
int fclose(FILE *stream);
该函数返回一个整型数。当文件关闭成功时, 返回0,　否则返回一个非零值。
可以根据函数的返回值判断文件是否关闭成功。
返回值：
该函数返回一个 FILE 指针。否则返回 NULL，且设置全局变量 errno 来标识错误。

#include <stdio.h>
int main()
{
    FILE * fp;
    //创建一个file.txt
    fp = fopen ("file.txt", "w+");
    fprintf(fp, "%s %s %s %d", "We", "are", "in", 2023);
    fclose(fp);
    return(0);
}

2、fwrite
描述：
把ptr 所指向的数组中的数据写入到给定流 stream 中。
声明：
下面是 fwrite() 函数的声明。
size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream)
参数：
ptr – 这是指向要被写入的元素数组的指针。
size – 这是要被写入的每个元素的大小，以字节为单位。
nmemb – 这是元素的个数，每个元素的大小为 size 字节。
stream – 这是指向 FILE 对象的指针，该 FILE 对象指定了一个输出流。
返回值：
如果成功，该函数返回一个 size_t 对象，表示元素的总数，该对象是一个整型数据类型。如果该数字与 nmemb 参数不同，则会显示一个错误。

#include<stdio.h>

int main ()
{
    FILE *fp;
    char str[] = "This is runoob.com";
    fp = fopen( "file.txt" , "w" );
    fwrite(str, sizeof(str) , 1, fp );
    fclose(fp);
    return(0);
}

3、fread
描述：
从给定流 stream 读取数据到 ptr 所指向的数组中。
声明：

size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream)

参数：
ptr – 这是指向带有最小尺寸 size*nmemb 字节的内存块的指针。
size – 这是要读取的每个元素的大小，以字节为单位。
nmemb – 这是元素的个数，每个元素的大小为 size 字节。
stream – 这是指向 FILE 对象的指针，该 FILE 对象指定了一个输入流。
返回值：
成功读取的元素总数会以 size_t 对象返回，size_t 对象是一个整型数据类型。如果总数与 nmemb 参数不同，则可能发生了一个错误或者到达了文件末尾。

#include <stdio.h>
#include <string.h>

int main()
{
    FILE *fp;
    char c[] = "This is runoob";
    char buffer[20];
    /* 打开文件用于读写 */
    fp = fopen("file.txt", "w+");
    /* 写入数据到文件 */
    fwrite(c, strlen(c) + 1, 1, fp);
    /* 查找文件的开头 */
    fseek(fp, 0, SEEK_SET);
    /* 读取并显示数据 */
    fread(buffer, strlen(c)+1, 1, fp);
    printf("%s\n", buffer);
    fclose(fp);
    return(0);
}

4、fclose函数
描述
关闭流 stream，刷新所有的缓冲区。
声明

int fclose(FILE *stream)

参数
stream – 这是指向 FILE 对象的指针，该 FILE 对象指定了要被关闭的流。
返回值
如果流成功关闭，则该方法返回零，如果失败，则返回 EOF。

#include <stdio.h>

int main()
{
    FILE *fp;
    fp = fopen("file.txt", "w");
    fprintf(fp, "%s", "这里是 runoob.com");
    fclose(fp);
    return(0);
}

5、fgets
描述
从指定的流 stream 读取一行，并把它存储在 str 所指向的字符串内。当读取 (n-1) 个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。

声明

char *fgets(char *str, int n, FILE *stream)

参数
str – 这是指向一个字符数组的指针，该数组用来存储要读取的字符串。
n – 这是要读取的最大字符数（包括最后的空字符）。通常是使用以 str 传递的数组长度。
stream – 这是指向 FILE 对象的指针，该 FILE 对象标识了要从中读取字符的流。
返回值
如果成功，该函数返回相同的 str 参数。如果到达文件末尾或者没有读取到任何字符，str 的内容保持不变，并返回一个空指针。
如果发生错误，返回一个空指针。

#include <stdio.h>

int main()
{
    FILE *fp;
    char str[60];
    /* 打开用于读取的文件 */
    fp = fopen("file.txt" , "r");
    if(fp == NULL) {
        perror("打开文件时发生错误");
        return(-1);
    }
    if( fgets (str, 60, fp)!=NULL ) {
        /* 向标准输出 stdout 写入内容 */
        puts(str);
    }
    fclose(fp);
    return(0);
}

6、fputs
描述：
把字符串写入到指定的流 stream 中，但不包括空字符。
声明：

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

参数：
str – 这是一个数组，包含了要写入的以空字符终止的字符序列。
stream – 这是指向 FILE 对象的指针，该 FILE 对象标识了要被写入字符串的流。
返回值：
该函数返回一个非负值，如果发生错误则返回 EOF。

#include <stdio.h>

int main ()
{
    FILE *fp;
    fp = fopen("file.txt", "w+");	//创建一个用于读写的空文件
    fputs("这是 C 语言。", fp);
    fputs("这是一种系统程序设计语言。", fp);
    fclose(fp);
    return(0);
}

注意：fgets和fputs是字符串读写，fread和fwrite是数据块读写。