fread_s

스트림에서 데이터를 읽습니다. 이 버전에는 CRT의 fread 보안 기능에 설명된 대로 보안 기능이 향상되었습니다.

구문

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을 반환하고 버퍼 콘텐츠가 변경되지 않습니다. null 포인터인 경우 stream 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다.bufferfread_s 계속해서 실행하도록 허용한 경우 이 함수는 errno를 EINVAL 로 설정하고 0을 반환합니다.

오류 코드에 대한 자세한 내용은 , , 및 를 참조하세요errno._sys_nerr_sys_errlist_doserrno

설명

fread_s 함수는 stream에서 입력 elementSize바이트 중 최대 count개 항목을 읽고 buffer에 저장합니다. 연결된 stream 파일 포인터(있는 경우)는 읽은 바이트 fread_s 수만큼 고급입니다. 지정된 스트림이 텍스트 모드에서 열리면 캐리지 리턴 라인 피드 쌍이 한 줄 피드 문자로 바뀝니다. 이렇게 바뀌더라도 파일 포인터 또는 반환 값에는 영향을 미치지 않습니다. 오류가 발생할 경우 파일 포인터 위치는 비활성화 상태입니다. 부분적으로 읽은 항목의 값을 확인할 수 없습니다.

이 함수는 다른 스레드를 잠급니다. 잠기지 않은 버전이 필요하면 _fread_nolock을 사용하세요.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

요구 사항

함수	필수 헤더
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;
   }
}

Contents of buffer before write/read:
        zyxwvutsrqponmlkjihgfe

Wrote 22 items

Number of 11-byte elements read = 2

Contents of buffer after write/read:
        zyxwvutsrqponmlkjihgfe

참고 항목

스트림 I/O
fwrite
_read