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과 버퍼 내용을 가능 하도록 설정할 수를 반환 합니다.경우 stream 또는 buffer 는 null 포인터 fread_s 에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사.계속 실행이 허용 되 면이 함수는 설정 errno 에 EINVAL 및 0을 반환 합니다.
오류 코드에 대 한 자세한 내용은 _doserrno, errno, _sys_errlist, 및 _sys_nerr.
설명
fread_s 함수를 읽어 최대 count 항목의 elementSize 에서 입력 바이트 stream 에 저장 하 고 buffer.연결 된 파일 포인터 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;
}
}