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 中，如同以对每个对象调用 size 次 fgetc ，并按顺序存储结果到转译为 unsigned char 数组的 buffer 中的相继位置。流的文件位置指示器前进读取的字符数。

若出现错误，则流的文件位置指示器的结果值不确定。若读入部分的元素，则元素值不确定。

参数

buffer	-	指向要读取的数组中首个对象的指针
size	-	每个对象的字节大小
count	-	要读取的对象数
stream	-	读取来源的输入文件流

返回值

成功读取的对象数，若出现错误或文件尾条件，则可能小于 count 。

若 size 或 count 为零，则 fread 返回零且不进行其他动作。

fread 不区别文件尾和错误，而调用者必须用 feof 和 ferror 鉴别出现者为何。

示例

运行此代码

#include <stdio.h>
 
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);
}

输出：

Array read successfully, contents: 
1.000000 2.000000 3.000000 4.000000 5.000000

引用

C11 标准（ISO/IEC 9899:2011）：

7.21.8.1 The fread function （第 335 页）

C99 标准（ISO/IEC 9899:1999）：

7.19.8.1 The fread function （第 301 页）

C89/C90 标准（ISO/IEC 9899:1990）：

4.9.8.1 The fread function

参阅

scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11)	从stdin、文件流或缓冲区读取格式化输入 (函数)
fgets	从文件流获取一个字符串 (函数)
fwrite	写入到文件 (函数)

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

fread

参数

返回值

示例

引用

参阅

导航