fread
스트림에서 데이터를 읽습니다.
size_t fread(
void *buffer,
size_t size,
size_t count,
FILE *stream
);
매개 변수
buffer
데이터에 대 한 저장소 위치입니다.size
항목 크기 (바이트)에서입니다.count
읽을 수 있도록 항목의 최대 수입니다.stream
포인터를 FILE 구조체입니다.
반환 값
fread실제로 전체 항목 수를 읽을 수 있습니다 반환 보다 작은 count 오류가 발생 한 경우 또는 파일의 끝에 도달 하기 전에 발생 하는 경우 count*.* 사용의 feof 또는 ferror 함수는 파일 끝 조건에서 읽기 오류를 구별할 수 있습니다.경우 size 또는 count 0으로, fread 0 및 버퍼 내용을 수 없습니다 변경 된 반환 합니다.경우 stream 또는 buffer 는 null 포인터 fread 의 설명에 따라 잘못 된 매개 변수 처리기를 호출 합니다. 매개 변수 유효성 검사.실행을 계속 수 있으면이 함수는 설정 errno 에 EINVAL 및 0을 반환 합니다.
참조 하십시오 _doserrno, errno, _sys_errlist, 및 _sys_nerr 이 및 기타 오류 코드에 대 한 자세한 내용은.
설명
fread 함수를 읽어 최대 count 항목의 size 에서 입력 바이트 stream 고에 저장 buffer*.* 연결 된 파일 포인터 stream (있는 경우)를 실제로 읽은 바이트 수 만큼 증가 합니다.지정 된 스트림에서 텍스트 모드에서 연 경우 캐리지 – 줄 바꿈 쌍 단일 줄 바꿈 문자로 바뀝니다.대체 파일 포인터 또는 반환 값에는 영향을 주지 않습니다.파일 포인터 위치를 오류가 발생 한 경우에 정해져 있지 않습니다.부분적으로 읽은 항목의 값을 확인할 수 없습니다.
이 함수를 다른 스레드에서 잠금을 설정합니다.비잠금 버전이 필요한 경우에 사용 _fread_nolock.
요구 사항
Function |
필수 헤더 |
|---|---|
fread |
<stdio.h> |
추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.
예제
// 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" );
}