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是空值的指標， fread中所述，將不正確的參數處理常式中，會叫用參數驗證。如果執行，則允許繼續執行，這個函式會將errno到EINVAL ，並傳回 0。
請參閱 _doserrno、 errno、 _sys_errlist，以及 _sys_nerr 如需有關這些項目，以及其他] 下，錯誤代碼。
備註
fread函式最多可讀取count的項目size位元組輸入stream ，並將儲存在buffer*.* 相關聯的檔案指標stream (如果有的話) 會增加實際讀取的位元組數目。如果指定的資料流以文字模式開啟，歸位字元 return–linefeed 組所取代單一的換行字元。取代已經不會影響檔案的指標或傳回的值。檔案指標位置是不確定發生了錯誤的。無法判定部分讀取項目的值。
這個函式是由其他執行緒鎖定。如果您需要的非鎖定版本，請使用_fread_nolock。
需求
Function |
所需的標頭 |
|---|---|
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" );
}