fread

定义在头文件 `<stdio.h>` 中
size_t fread( void buffer, size_t size, size_t count, FILE stream );		(直到 C99)
size_t fread( void restrict buffer, size_t size, size_t count, FILE restrict stream );		(自 C99 起)

从给定的输入流 stream 中读取最多 count 个对象到数组 buffer 中，如同通过调用 fgetc size 次来读取每个对象，并将结果按获取的顺序存储到 buffer 的连续位置中，buffer 被重新解释为一个 unsigned char 数组。流的文件位置指示器将根据读取的字符数进行更新。

如果发生错误，流的文件位置指示器的结果值将是不确定的。如果部分元素被读取，其值将是不确定的。

[编辑] 参数

buffer	-	指向存储读取对象的数组的指针
size	-	每个对象的大小（以字节为单位）
count	-	要读取的对象数量
stream	-	要读取的流

[编辑] 返回值

成功读取的对象数量，如果发生错误或文件结束条件，则可能小于 count。

如果 size 或 count 为零，fread 将返回零，并且不执行任何其他操作。

fread 不区分文件结束和错误，调用者必须使用 feof 和 ferror 来确定发生了哪种情况。

[编辑] 示例

运行此代码

#include <stdio.h>
 
enum { SIZE = 5 };
 
int main(void)
{
    const double a[SIZE] = {1.0, 2.0, 3.0, 4.0, 5.0};
    printf("Array has size %ld bytes, element size: %ld\n", sizeof a, sizeof *a);
    FILE *fp = fopen("test.bin", "wb"); // must use binary mode
    fwrite(a, sizeof *a, SIZE, fp); // writes an array of doubles
    fclose(fp);
 
    double b[SIZE];
    fp = fopen("test.bin","rb");
    const size_t ret_code = fread(b, sizeof b[0], SIZE, fp); // reads an array of doubles
    if (ret_code == SIZE)
    {
        printf("Array at %p read successfully, contents:\n", (void*)&a);
        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);
}

可能的输出

Array has size 40 bytes, element size: 8
Array at 0x1337f00d6960 read successfully, contents:
1.000000 2.000000 3.000000 4.000000 5.000000

[编辑] 参考资料

C23 标准 (ISO/IEC 9899:2024)

7.21.8.1 fread 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.21.8.1 fread 函数 (p: 243-244)

C11 标准 (ISO/IEC 9899:2011)

7.21.8.1 fread 函数 (p: 335)

C99 标准 (ISO/IEC 9899:1999)

7.19.8.1 fread 函数 (p: 301)

C89/C90 标准 (ISO/IEC 9899:1990)

4.9.8.1 fread 函数

[编辑] 参见

scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11)	从 stdin、文件流或缓冲区中读取格式化的输入 (函数) [编辑]
fgets	从文件流中获取字符字符串 (函数) [编辑]
fwrite	写入文件 (函数) [编辑]
C++ 文档 for fread

编译器支持
语言
头文件
类型支持
程序实用程序
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用程序
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.com

命名空间

变体

视图

操作