?
This document uses PHP Chinese website manual Release
在頭文件<stdio.h>中定義 | ||
---|---|---|
size_t fread(void * buffer,size_t size,size_t count,F(xiàn)ILE * stream); | (直到C99) | |
size_t fread(void * restrict buffer,size_t size,size_t count,F(xiàn)ILE * restrict stream); | (自C99以來) |
從給定的輸入流中讀取count
對象到數(shù)組中buffer
,stream
就像調(diào)用fgetc
size
每個對象的時間一樣,并將結(jié)果按獲得的順序存儲到連續(xù)的位置buffer
,并重新解釋為數(shù)組unsigned char
。流的文件位置指示符按讀取的字符數(shù)進行提前。
如果發(fā)生錯誤,則流的文件位置指示符的結(jié)果值不確定。如果讀取了部分元素,則其值是不確定的。
緩沖 | - | 指向存儲讀取對象的數(shù)組的指針 |
---|---|---|
尺寸 | - | 每個對象的大小以字節(jié)為單位 |
計數(shù) | - | 要讀取的對象的數(shù)量 |
流 | - | 要讀取的流 |
成功讀取的對象數(shù)量,可能少于count
發(fā)生錯誤或文件結(jié)束條件時的數(shù)量。
如果size
或者count
為零,則fread
返回零且不執(zhí)行其他操作。
fread
不區(qū)分文件結(jié)束和錯誤,呼叫者必須使用feof
并ferror
確定發(fā)生的事件。
#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標(biāo)準(zhǔn)(ISO / IEC 9899:2011):
7.21.8.1 fread函數(shù)(p:335)
C99標(biāo)準(zhǔn)(ISO / IEC 9899:1999):
7.19.8.1 fread函數(shù)(p:301)
C89 / C90標(biāo)準(zhǔn)(ISO / IEC 9899:1990):
4.9.8.1 fread函數(shù)