【C语言】文件操作函数详解

LuckiBit

发布于 2024-12-11 12:10:12

23800

代码可运行

文章被收录于专栏：C语言C语言

运行总次数：0

代码可运行

C语言文件操作函数详解

C语言提供了一组标准库函数来处理文件操作，这些函数定义在 <stdio.h> 头文件中。文件操作包括文件的打开、读写、关闭以及文件属性的查询等。以下是常用文件操作函数的详细讲解，包括函数原型、参数说明、返回值说明、示例代码和表格汇总。

表格汇总

函数	作用	示例	输出
fopen	打开文件	fopen("file.txt", "r")	文件指针
fclose	关闭文件	fclose(file)	返回 0 或 EOF
fread	从文件中读取数据	fread(buffer, size, count, file)	读取的数据
fwrite	将数据写入文件	fwrite(buffer, size, count, file)	写入的数据
fseek	设置文件位置指针	fseek(file, offset, origin)	返回 0 或 EOF
ftell	获取文件位置指针	ftell(file)	文件位置
rewind	重置文件位置指针到文件开头	rewind(file)	无返回值
fprintf	格式化输出到文件	fprintf(file, "data: %d", value)	格式化的字符串
fscanf	从文件中格式化输入	fscanf(file, "%d", &value)	读取的值
feof	检查文件是否到达文件末尾	feof(file)	返回非零值或 0
ferror	检查文件操作是否发生错误	ferror(file)	错误代码
clearerr	清除文件流的错误和EOF标志	clearerr(file)	无返回值

1. `fopen`

函数原型:

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

参数说明:

filename: 要打开的文件的路径。
mode: 文件打开模式，如 "r"（只读）、"w"（只写）、"a"（追加）等。

返回值说明:

成功时，返回指向 FILE 类型的文件指针；失败时，返回 NULL。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;

    file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    fprintf(file, "Hello, World!\n");
    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
fopen	打开文件	fopen("example.txt", "w")	文件指针或 NULL

2. `fclose`

函数原型:

int fclose(FILE *stream);

参数说明:

stream: 要关闭的文件指针。

返回值说明:

成功时，返回 0；失败时，返回 EOF。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;

    file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    fprintf(file, "Hello, World!\n");
    if (fclose(file) != 0) {
        perror("无法关闭文件");
        return 1;
    }

    return 0;
}

表格说明:

函数	作用	示例	输出
fclose	关闭文件	fclose(file)	0 或 EOF

3. `fread`

函数原型:

size_t fread(void *ptr, size_t size, size_t count, FILE *stream);

参数说明:

ptr: 指向存储读取数据的内存块的指针。
size: 每个元素的字节数。
count: 要读取的元素数量。
stream: 文件指针。

返回值说明:

返回成功读取的元素数量。如果返回值小于 count，可能发生了文件结束或读取错误。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    char buffer[20];
    size_t bytesRead;

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    bytesRead = fread(buffer, sizeof(char), sizeof(buffer) - 1, file);
    buffer[bytesRead] = '\0'; // 确保字符串结束符
    printf("读取数据: %s\n", buffer);

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
fread	从文件中读取数据	fread(buffer, size, count, file)	读取的数据

4. `fwrite`

函数原型:

size_t fwrite(const void *ptr, size_t size, size_t count, FILE *stream);

参数说明:

ptr: 指向要写入文件的内存块的指针。
size: 每个元素的字节数。
count: 要写入的元素数量。
stream: 文件指针。

返回值说明:

返回成功写入的元素数量。如果返回值小于 count，可能发生了写入错误。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    const char *text = "Hello, File Writing!";

    file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    if (fwrite(text, sizeof(char), strlen(text), file) < strlen(text)) {
        perror("写入文件失败");
        fclose(file);
        return 1;
    }

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
fwrite	将数据写入文件	fwrite(buffer, size, count, file)	写入的数据

5. `fseek`

函数原型:

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

参数说明:

stream: 文件指针。
offset: 从 whence 指定的位置偏移的字节数。
whence: 指定偏移的起始位置，可以是 SEEK_SET（文件开头）、SEEK_CUR（当前位置）、SEEK_END（文件末尾）。

返回值说明:

成功时返回 0；失败时返回 -1。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    long position;

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    fseek(file, 5, SEEK_SET);  // 从文件开头偏移5个字节
    position = ftell(file);    // 获取当前文件位置
    printf("文件位置: %ld\n", position); // 输出: 文件位置: 5

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
fseek	设置文件位置指针	fseek(file, offset, whence)	成功时 0 或 -1

6. `ftell`

函数原型:

long ftell(FILE *stream);

参数说明:

stream: 文件指针，指向一个已打开的文件。

返回值说明:

返回从文件开头到当前位置的字节数。成功时返回当前文件位置的偏移量，失败时返回 -1L。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    long position;

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    fseek(file, 10, SEEK_SET); // 从文件开头偏移10个字节
    position = ftell(file);    // 获取当前文件位置
    printf("文件当前位置: %ld\n", position); // 输出: 文件当前位置: 10

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
ftell	获取文件当前位置	ftell(file)	文件当前位置: 10

7. `rewind`

函数原型:

void rewind(FILE *stream);

参数说明:

stream: 文件指针，指向一个已打开的文件。

返回值说明:

无返回值。此函数将文件位置指针重置到文件的开头。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    char buffer[50];

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    fread(buffer, sizeof(char), sizeof(buffer) - 1, file); // 读取文件数据
    buffer[sizeof(buffer) - 1] = '\0'; // 确保字符串结束符

    rewind(file); // 重置文件指针到开头
    fread(buffer, sizeof(char), sizeof(buffer) - 1, file); // 重新读取文件数据
    buffer[sizeof(buffer) - 1] = '\0'; // 确保字符串结束符

    printf("重新读取的数据: %s\n", buffer); // 输出重新读取的数据

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
rewind	重置文件指针到文件开头	rewind(file)	无输出（重置指针）

8. `fprintf`

函数原型:

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

参数说明:

stream: 文件指针，指向一个已打开的文件。
format: 格式字符串，用于指定输出格式。
...: 其他格式化数据，根据 format 中的占位符提供。

返回值说明:

成功时，返回输出的字符总数；失败时返回 EOF。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    int number = 42;

    file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    if (fprintf(file, "The answer is %d\n", number) < 0) {
        perror("写入文件失败");
        fclose(file);
        return 1;
    }

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
fprintf	格式化输出到文件	fprintf(file, "data: %d", value)	格式化的字符串

9. `fscanf`

函数原型:

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

参数说明:

stream: 文件指针，指向一个已打开的文件。
format: 格式字符串，用于指定输入格式。
...: 其他格式化输入，根据 format 中的占位符提供。

返回值说明:

成功时，返回成功匹配和赋值的项目数；失败时返回 EOF。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    int number;

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    if (fscanf(file, "The answer is %d", &number) != 1) {
        perror("读取文件失败");
        fclose(file);
        return 1;
    }

    printf("读取的数字: %d\n", number);

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
fscanf	从文件中格式化输入	fscanf(file, "%d", &value)	读取的值

10. `feof`

函数原型:

int feof(FILE *stream);

参数说明:

stream: 文件指针，指向一个已打开的文件。

返回值说明:

如果到达文件末尾，返回非零值；否则返回 0。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    char buffer[20];

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    while (fread(buffer, sizeof(char), sizeof(buffer) - 1, file) > 0) {
        buffer[sizeof(buffer) - 1] = '\0';
        printf("读取的数据: %s\n", buffer);
    }

    if (feof(file)) {
        printf("到达文件末尾\n");
    } else {
        printf("文件读取错误\n");
    }

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
feof	检查文件是否到达文件末尾	feof(file)	到达文件末尾

11. `ferror`

函数原型:

int ferror(FILE *stream);

参数说明:

stream: 文件指针，指向一个已打开的文件。

返回值说明:

返回非零值表示发生了错误；返回 0 表示没有错误。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    char buffer[20];

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    if (fread(buffer, sizeof(char), sizeof(buffer) - 1, file) < 0) {
        if (ferror(file)) {
            perror("读取文件错误");
        }
        fclose(file);
        return 1;
    }

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
ferror	检查文件操作是否发生错误	ferror(file)	错误代码

12. `clearerr`

函数原型:

void clearerr(FILE *stream);

参数说明:

stream: 文件指针，指向一个已打开的文件。

返回值说明:

无返回值。此函数清除流的错误标志和EOF标志。

示例代码:

#include <stdio.h>

int main() {
    FILE *file;
    char buffer[10];

    file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("无法打开文件");
        return 1;
    }

    fread(buffer, sizeof(char), sizeof(buffer) - 1, file); // 模拟读取
    if (ferror(file)) {
        printf("读取文件时发生错误\n");
        clearerr(file); // 清除错误标志
    }

    // 继续操作文件

    fclose(file);

    return 0;
}

表格说明:

函数	作用	示例	输出
clearerr	清除文件流的错误和EOF标志	clearerr(file)	无输出（清除标志）

13. 总结

C语言的文件操作函数提供了一系列用于处理文件的工具，包括打开、关闭、读写、定位文件指针以及检查文件状态等。这些函数为程序员提供了灵活的文件管理能力，从简单的文件读写到复杂的文件处理任务，都可以通过这些标准库函数来实现。掌握这些函数的使用对于编写健壮且可靠的C程序至关重要。

14. 附录：函数参考表

函数	作用	示例	返回值
fopen	打开文件	fopen("file.txt", "r")	文件指针或 NULL
fclose	关闭文件	fclose(file)	0 或 EOF
fread	从文件中读取数据	fread(buffer, size, count, file)	读取的数据
fwrite	将数据写入文件	fwrite(buffer, size, count, file)	写入的数据
fseek	设置文件位置指针	fseek(file, offset, SEEK_SET)	0 或 EOF
ftell	获取文件当前位置	ftell(file)	文件位置
rewind	重置文件位置指针到文件开头	rewind(file)	无返回值
fprintf	格式化输出到文件	fprintf(file, "data: %d", value)	格式化的字符串
fscanf	从文件中格式化输入	fscanf(file, "%d", &value)	读取的值
feof	检查文件是否到达文件末尾	feof(file)	非零值或 0
ferror	检查文件操作是否发生错误	ferror(file)	错误代码
clearerr	清除文件流的错误和EOF标志	clearerr(file)	无返回值

通过理解和运用这些文件操作函数，可以有效地进行文件读写操作，并处理各种文件相关的错误和状态检查。这对于实现文件管理功能以及确保程序的健壮性具有重要意义。

15. 结束语

本节内容已经全部介绍完毕，希望通过这篇文章，大家对C语言文件操作函数有了更深入的理解和认识。
感谢各位的阅读和支持，如果觉得这篇文章对你有帮助，请不要吝惜你的点赞和评论，这对我们非常重要。再次感谢大家的关注和支持！

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2024-12-11，如有侵权请联系 cloudcommunity@tencent.com 删除

指针

本文分享自作者个人站点/博客前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度

【C语言】文件操作函数详解

【C语言】文件操作函数详解

C语言文件操作函数详解

表格汇总

1. `fopen`

2. `fclose`

3. `fread`

4. `fwrite`

5. `fseek`

6. `ftell`

7. `rewind`

8. `fprintf`

9. `fscanf`

10. `feof`

11. `ferror`

12. `clearerr`

13. 总结

14. 附录：函数参考表

15. 结束语

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

【C语言】文件操作函数详解

【C语言】文件操作函数详解

C语言文件操作函数详解

表格汇总

1. fopen

2. fclose

3. fread

4. fwrite

5. fseek

6. ftell

7. rewind

8. fprintf

9. fscanf

10. feof

11. ferror

12. clearerr

13. 总结

14. 附录：函数参考表

15. 结束语

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

1. `fopen`

2. `fclose`

3. `fread`

4. `fwrite`

5. `fseek`

6. `ftell`

7. `rewind`

8. `fprintf`

9. `fscanf`

10. `feof`

11. `ferror`

12. `clearerr`