fread

fread 함수는 스트림에서 바이너리 데이터를 읽어 버퍼에 저장하는 표준 C 라이브러리 함수이다.

정의[편집]

<stdio.h> 헤더 파일에 다음과 같이 정의되어 있다.

size_t fread (void * DstBuf, size_t ElementSize, size_t Count, FILE * FileStream)

인수[편집]

각 인수는 다음과 같은 의미를 가지고 있다.

DstBuf: 입력받은 데이터를 저장할 버퍼의 주소
ElementSize: 원소 1개의 크기
Count: 입력 받을 원소의 개수
FileStream: 파일 스트림

반환값[편집]

실제로 읽어들인 원소의 개수를 반환한다. 반환값이 Count보다 작으면 오류나 파일 끝(EOF)의 경우이다.

동작[편집]

파일 스트림으로부터 ElementSize크기의 바이너리 데이터를 Count회 읽어 DstBuf에 저장한다. Count회 입력이 완료되거나 EOF를 입력받았을 때, 혹은 오류가 발생했을 때 입력을 마친다. 함수가 종료될 때 입력이 완료된 곳까지 파일 포인터를 이동시키고 실제로 읽어들인 원소의 개수를 반환한다.

예제[편집]

 #include <stdio.h>

 int main(void)
 {
     FILE *file_ptr;
     char arr[6];
     size_t iCount;

     file_ptr = fopen("sample.txt", "rb");
     if(file_ptr==NULL) return 1;

     iCount = fread(arr, sizeof(char), sizeof(arr), file_ptr);
     fclose(file_ptr);

     return 0;
 }

위 예제는 sample.txt에서 6바이트를 읽어(파일이 6바이트보다 크다는 가정 하에) arr에 저장하고 읽은 바이트 수를 iCount에 저장한다.

같이 보기[편집]

fwrite