fread

ストリームからデータを読み込みます。

size_t fread( 
   void *buffer,
   size_t size,
   size_t count,
   FILE *stream 
);

パラメーター

• buffer
  データの格納場所。

• size
  バイトの項目のサイズ。

• count
  読み取る最大項目数。

• stream
  FILE 構造体へのポインター。

戻り値

fread はエラーが発生した場合やファイルの終端に到達する count の前に発生実際に読み込まれる count 未満である可能性があるすべての項目数を返します *。*EOF が見つかりました。状態と読み取りエラーを識別するために feof または ferror の関数を使用します。size または count が 0 の場合fread は 0 を返しバッファーの内容は変更されません。streambuffer またはが null ポインターの場合fread は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合、この関数は errno を EINVAL に設定し、0 を返します。

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

fread の関数は入力 stream から size のバイト count の項目の読み取りbuffer に格納します *。*stream に関連付けられたファイル ポインターは読み取ったバイト数 (1) は大きくなります。指定したストリームがテキスト モードで開くと復帰と改行の組み合わせにより一つの改行文字に置き換えられます。コントロールはファイル ポインターまたは戻り値に影響しません。ファイル ポインターの位置にエラーが発生した場合は不確定です。部分的に読み取り項目の値は特定することはできません。

この関数は他のスレッドをロックします。ロックされていないバージョンが必要な場合は_fread_nolock を使用します。

必要条件

Function	必須ヘッダー
fread	<stdio.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

// 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" );
}

同等の .NET Framework 関数

System:: IO:: FileStream:: 読み取り

参照

関連項目

ストリーム入出力

fwrite

_read