©
本文檔使用 php中文網手册 發布
在头文件<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函数