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

表格汇总

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

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;
}

表格说明:

13. 总结

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

14. 附录：函数参考表

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

15. 结束语

相关文章：

• 指针的神秘探险：从入门到精通的奇幻之旅 !