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을 반환하고 버퍼 콘텐츠가 변경되지 않습니다. null 포인터인 경우 stream 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다.buffer fread_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