C 언어 코딩 도장

70 파일에서 문자열을 읽고 쓰기

프로그래밍에서 중요한 축을 차지하는 부분이 파일 처리입니다. 이번 유닛부터는 파일에서 값을 쓰는 방법과 읽는 방법 알아보겠습니다.

70.1 서식을 지정하여 파일에 문자열 쓰기

지금까지 printf로 서식을 지정하여 문자열을 화면에 출력하고, sprintf로 서식을 지정하여 문자열을 생성했습니다. 그럼 문자열을 파일에 쓸 수는 없을까요? 이때는 printf의 파일 버전인 fprintf를 사용하면 됩니다.

파일에 문자열을 쓸 때는 먼저 fopen 함수로 파일을 열어서 파일 포인터를 얻은 뒤 fprintf 함수를 사용합니다(stdio.h 헤더 파일에 선언되어 있습니다).

• FILE *포인터이름 = fopen(파일명, 파일모드);
  • FILE *fopen(char const *_FileName, char const *_Mode);
  • 성공하면 파일 포인터를 반환, 실패하면 NULL을 반환
• fprintf(파일포인터, 서식, 값1, 값2, ...);
  • int fprintf(FILE * const _Stream, char const * const _Format, ...);
  • 성공하면 쓴 문자열의 길이를 반환, 실패하면 음수를 반환
• fclose(파일포인터);
  • int fclose(FILE *_stream);
  • 성공하면 0을 반환, 실패하면 EOF(-1)를 반환

다음 내용을 소스 코드 편집 창에 입력한 뒤 실행해보세요.

file_write_format.c

#define _CRT_SECURE_NO_WARNINGS    // fopen 보안 경고로 인한 컴파일 에러 방지
#include <stdio.h>     // fopen, fprintf, fclose 함수가 선언된 헤더 파일

int main()
{
    FILE *fp = fopen("hello.txt", "w");     // hello.txt 파일을 쓰기 모드(w)로 열기.
                                            // 파일 포인터를 반환

    fprintf(fp, "%s %d\n", "Hello", 100);   // 서식을 지정하여 문자열을 파일에 저장

    fclose(fp);    // 파일 포인터 닫기

    return 0;
}

Visual Studio에서 Ctrl+F5 키를 눌러서 프로그램을 실행하면 .c 파일이 있는 폴더에 hello.txt 파일이 생성됩니다. 메모장이나 기타 텍스트 편집기를 사용하여 파일을 열어보면 다음과 같이 "Hello 100" 문자열이 저장된 것을 볼 수 있습니다.

hello.txt

Hello 100

파일을 사용하기 위해서는 fopen 함수로 파일을 열어서 파일 포인터를 얻어야 합니다. 다음과 같이 읽을 파일 이름은 hello.txt로 지정하고, 파일을 생성하여 내용을 쓸 것이므로 파일 모드를 "w"로 지정해줍니다. 파일 열기에 성공하면 파일 포인터를 반환하고, 실패하면 NULL을 반환합니다.

//    ↓ 파일 포인터
FILE *fp = fopen("hello.txt", "w");           // hello.txt 파일을 쓰기 모드(w)로 열기. 
//                   ↑          ↖ 파일 모드   // 파일 포인터를 반환
//        파일 이름 또는 파일 경로

여기서 FILE 구조체는 stdio.h 헤더 파일에 정의되어 있으며 보통 FILE과 *를 합쳐서 파일 포인터라고 부릅니다. 포인터 변수의 이름도 file pointer의 약자로 fp를 사용하겠습니다.

다음은 파일 모드의 종류입니다.

파일 모드는 보통 "rb", "rt", "w+b", "w+t"와 같이 읽기/쓰기 모드와 텍스트/바이너리 모드를 조합해서 사용합니다. t와 b는 단독으로 사용할 수 없습니다.

이제 파일 포인터를 얻었으니 fprintf 함수로 문자열을 파일에 씁니다. 먼저 앞에서 얻은 파일 포인터를 지정하고 서식과 값을 순서대로 지정하면 됩니다.

fprintf(fp, "%s %d\n", "Hello", 100);   // 서식을 지정하여 문자열을 파일에 저장

이렇게 하면 "Hello"와 정수 100을 합쳐서 문자열 "Hello 100"이 hello.txt 파일에 저장됩니다.

파일 쓰기가 끝났으면 반드시 fclose 함수로 파일 포인터를 닫아줍니다. 파일 포인터 fp도 구조체 FILE 크기만큼 동적 메모리를 할당한 것이기 때문에 fclose 함수로 닫아주지 않으면 메모리 누수가 발생합니다.

fclose(fp);    // 파일 포인터 닫기

서식을 지정하여 파일에 문자열을 쓰는 과정을 그림으로 나타내면 다음과 같습니다.

한 가지 특이한 점은 fprintf 함수로도 화면에 문자열을 출력할 수 있다는 점인데 stdout이라는 매크로를 활용하면 됩니다.

fprintf(stdout, "%s %d\n", "Hello", 100);   // Hello 100: 서식을 지정하여 화면(stdout)에 문자열 출력

즉, fprintf(stdout, ...);은 printf 함수와 동작이 같습니다.