fread
從資料流讀取資料。
size_t fread(
void *buffer,
size_t size,
size_t count,
FILE *stream
);
參數
buffer
資料儲存位置size
項目大小 (以位元組為單位)。count
要讀取的最大項目數。stream
指向 FILE 結構的指標。
傳回值
fread 傳回實際讀取的完整項目的數目，此數目可能小於 count ，如果發生錯誤，或如果檔案結尾在達到 count之前發生*。*使用 feof 或 ferror 函式具有文件關閉條件差異讀取錯誤。 如果 size 或 count 為 0 時， fread 會傳回 0，而緩衝區內容不會變更。 如果 stream 或 buffer 為 null 指標，則fread 叫用無效參數處理常式，如 參數驗證 中所述。 如果允許繼續執行，函式將 errno 設置為 EINVAL 並回傳 0 。
如需更多關於這些和其他回傳碼的資訊，請參閱 _doserrno 、 errno 、 _sys_errlist 和 _sys_nerr (_doserrno, errno, _sys_errlist, and _sys_nerr) 。
備註
fread 函式。 buffer讀取由 size 位元組決定 count 項目從輸入 stream 的並儲存它們*。*檔案指標相關聯的 stream (如果有的話) 是實際讀取的位元組數目增加。 如果指定的資料流文字模式開啟，重設為一組可用於唯一換行字元取代。 取代為對檔案指標或傳回值沒有作用。 如果發生錯誤，檔案指標位置為不定。 部分讀取項目的值無法判斷的。
這個函式鎖定其他執行緒。 如果您需要非鎖定版本，請使用 _fread_nolock。
需求
功能 |
必要的標頭 |
|---|---|
fread |
<stdio.h> |
如需其他相容性資訊，請參閱＜簡介＞中的相容性。
範例
// crt_fread.c
// This program opens a file named FREAD.OUT and
// writes 25 characters to the file. It then tries to open
// FREAD.OUT and read in 25 characters. If the attempt succeeds,
// the program displays the number of actual items read.
#include <stdio.h>
int main( void )
{
FILE *stream;
char list[30];
int i, numread, numwritten;
// Open file in text mode:
if( fopen_s( &stream, "fread.out", "w+t" ) == 0 )
{
for ( i = 0; i < 25; i++ )
list[i] = (char)('z' - i);
// Write 25 characters to stream
numwritten = fwrite( list, sizeof( char ), 25, stream );
printf( "Wrote %d items\n", numwritten );
fclose( stream );
}
else
printf( "Problem opening the file\n" );
if( fopen_s( &stream, "fread.out", "r+t" ) == 0 )
{
// Attempt to read in 25 characters
numread = fread( list, sizeof( char ), 25, stream );
printf( "Number of items read = %d\n", numread );
printf( "Contents of buffer = %.25s\n", list );
fclose( stream );
}
else
printf( "File could not be opened\n" );
}