fread_s
ストリームからデータを読み込みます。fread のこのバージョンに CRT のセキュリティ機能に説明されているように、のセキュリティが強化があります。
size_t fread_s(
void *buffer,
size_t bufferSize,
size_t elementSize,
size_t count,
FILE *stream
);
パラメーター
buffer
データの格納場所。bufferSize
バイトのコピー先のバッファーのサイズ。elementSize
バイトを読み取る項目のサイズ。count
読み取る項目の最大数。stream
FILE 構造体へのポインター。
戻り値
fread_s ( count に達する前にファイルの読み取りエラーまたは端に当たる count 未満である可能性もあるバッファーに読込まれた全体) 項目数を返します。ファイルの終端状態にエラーを識別するために feof または ferror 関数を使用します。size か count が 0 の場合、fread_s は 0 を返し、バッファーの内容は変更されません。streambuffer またはが null ポインターの場合、fread_s は パラメーターの検証に説明されているように、無効なパラメーター ハンドラーが実行されます。実行の継続が許可された場合、この関数は errno を EINVAL に設定し、0 を返します。
エラー コードの詳細については、_doserrno、errno、_sys_errlist と _sys_nerrを参照してください。
解説
fread_s の関数は入力 stream から elementSize のバイト count の項目まで読み取り、bufferに値を格納します。(1 stream 場合) に関連付けられたファイル ポインターは、実際に読み込んだバイト数が乗算されます。指定したストリームがテキスト モードで開いて、復帰とライン フィードのペアは、一つの改行文字に置き換えられます。の置換は、ファイル ポインターまたは戻り値には影響しません。ファイル ポインターの位置は、エラーが発生した場合は不確定です。部分的に読み取り項目の値は、特定することはできません。
この関数は、他のスレッドをロックします。ロックしないバージョンが必要な場合は、_fread_nolockを使用します。
必要条件
Function |
必須ヘッダー |
|---|---|
fread_s |
<stdio.h> |
追加の互換性の詳細については、互換性を参照してください。
使用例
// crt_fread_s.c
// Command line: cl /EHsc /nologo /W4 crt_fread_s.c
//
// This program opens a file that's named FREAD.OUT and
// writes characters to the file. It then tries to open
// FREAD.OUT and read in characters by using fread_s. If the attempt succeeds,
// the program displays the number of actual items read.
#include <stdio.h>
#define BUFFERSIZE 30
#define DATASIZE 22
#define ELEMENTCOUNT 2
#define ELEMENTSIZE (DATASIZE/ELEMENTCOUNT)
#define FILENAME "FREAD.OUT"
int main( void )
{
FILE *stream;
char list[30];
int i, numread, numwritten;
for ( i = 0; i < DATASIZE; i++ )
list[i] = (char)('z' - i);
list[DATASIZE] = '\0'; // terminal null so we can print it
// Open file in text mode:
if( fopen_s( &stream, FILENAME, "w+t" ) == 0 )
{
// Write DATASIZE characters to stream
printf( "Contents of buffer before write/read:\n\t%s\n\n", list );
numwritten = fwrite( list, sizeof( char ), DATASIZE, stream );
printf( "Wrote %d items\n\n", numwritten );
fclose( stream );
} else {
printf( "Problem opening the file\n" );
return -1;
}
if( fopen_s( &stream, FILENAME, "r+t" ) == 0 ) {
// Attempt to read in characters in 2 blocks of 11
numread = fread_s( list, BUFFERSIZE, ELEMENTSIZE, ELEMENTCOUNT, stream );
printf( "Number of %d-byte elements read = %d\n\n", ELEMENTSIZE, numread );
printf( "Contents of buffer after write/read:\n\t%s\n", list );
fclose( stream );
} else {
printf( "File could not be opened\n" );
return -1;
}
}