C语言中文开发手册
目录搜索
提交中...

©
本文档使用 php.cn手册 发布

文字
分享

在头文件<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以来）

从给定的输入流中读取count对象到数组中buffer，stream就像调用fgetc size每个对象的时间一样，并将结果按获得的顺序存储到连续的位置buffer，并重新解释为数组unsigned char。流的文件位置指示符按读取的字符数进行提前。

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

参数

缓冲

-

指向存储读取对象的数组的指针

尺寸

-

每个对象的大小以字节为单位

计数

-

要读取的对象的数量

流

-

要读取的流

返回值

成功读取的对象数量，可能少于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"); // 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");
    size_t ret_code = fread(b, sizeof *b, SIZE, fp); // reads an array of doubles    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 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函数

上一篇：fputws下一篇：freopen