C 언어에서 파일 다루기

4/29/2023
10 minutes to read

파일에서 데이터를 읽는 것은 많은 프로그램에서 자주 수행되는 작업입니다. C 언어에서 파일을 읽는 방법을 다루는 이 아티클에서는 간단한 파일 읽기 프로그램을 소개하고, 코드와 출력 결과를 설명합니다.

예제: 파일 읽기

이 예제에서는 텍스트 파일을 읽고 그 내용을 출력하는 프로그램을 작성합니다. 이 프로그램은 'example.txt' 파일을 읽기 모드로 연 후, 파일의 내용을 한 줄씩 읽어서 콘솔에 출력합니다. 파일을 열지 못했을 경우, 에러 메시지를 출력하고 프로그램을 종료합니다.

코드: file_read.c

#define _CRT_SECURE_NO_WARNINGS // Visual Studio에서 보안 경고를 무시하도록 설정
#include <stdio.h> // 표준 입출력 라이브러리를 포함

int main(void)
{
    FILE* file; // 파일 포인터 선언
    char buffer[80]; // 파일에서 읽은 문자열을 저장할 버퍼

    file = fopen("example.txt", "r"); // 'example.txt' 파일을 읽기 모드로 연다
    if (file == NULL) // 파일 열기에 실패한 경우
    {
        printf("파일을 열지 못했습니다.\n"); // 에러 메시지 출력
        return 1; // 프로그램 종료 (1 반환)
    }

    // 파일의 끝에 도달할 때까지 한 줄씩 읽어서 버퍼에 저장
    while (fgets(buffer, sizeof(buffer), file) != NULL)
    {
        printf("%s", buffer); // 읽은 줄을 출력
    }

    fclose(file); // 파일을 닫는다
    return 0; // 프로그램 종료 (0 반환)
}

출력 결과

'example.txt' 파일을 찾지 못하거나 파일을 열지 못했을 경우 다음과 같은 출력 결과를 보여줍니다.

파일을 열지 못했습니다.

'example.txt' 파일이 성공적으로 열렸다면, 해당 파일의 내용을 한 줄씩 콘솔에 출력합니다.

Visual Studio에서 C 언어 프로젝트에서 외부 텍스트 파일 다루기

Visual Studio를 사용하여 C 언어 프로젝트를 작성할 때 외부 텍스트 파일을 읽거나 쓰는 것은 일반적인 작업 중 하나입니다. 이 글에서는 Visual Studio 환경에서 텍스트 파일을 어디에 위치시켜야 하는지 설명합니다.

텍스트 파일 위치

Visual Studio 기준으로 텍스트 파일은 프로젝트의 실행 파일이 생성되는 디렉터리에 만들어야 합니다. 일반적으로 실행 파일은 Debug 또는 Release 폴더에 생성됩니다. 프로젝트를 빌드하고 실행할 때, Visual Studio는 이 폴더를 현재 작업 디렉터리로 사용합니다.

단, 실제로 사용하다보면, 환경에 따라서 소스와 같은 폴더에 텍스트 파일이 생성될 수 있으니 직접 실행해보는 것을 권장합니다.

예를 들어 프로젝트 구조가 다음과 같다면:

YourProject/
    ├── Debug/
    │   ├── YourProject.exe
    ├── Release/
    │   ├── YourProject.exe
    ├── Source/
    │   ├── main.c
    └── YourProject.sln

example.txt 파일을 Debug 또는 Release 폴더에 위치시키면 됩니다.

절대 경로 사용

파일 위치를 명확하게 지정하고 싶다면, 절대 경로를 사용하여 파일을 여는 것이 좋습니다. 예를 들어, example.txt 파일이 프로젝트 폴더에 있다면, 다음과 같이 파일을 여실 수 있습니다.

file = fopen("C:/YourProjectPath/YourProject/example.txt", "r");

이렇게 하면 프로젝트 실행 환경에 따라 파일 위치를 변경할 필요가 없습니다. 절대 경로를 사용할 때 주의할 점은 파일 경로가 다른 컴퓨터에서도 동일해야 한다는 것입니다. 따라서 프로젝트를 공유하거나 이식성을 유지하려면 상대 경로를 사용하는 것이 좋습니다.

파일이 없으면 생성하고 읽기: C 언어 예제

C 언어를 사용하여 파일이 없는 경우 파일을 생성하고 읽는 예제를 소개합니다.

코드: file_read_create.c

#define _CRT_SECURE_NO_WARNINGS // Visual Studio에서 보안 경고를 무시하도록 설정
#include <stdio.h> // 표준 입출력 라이브러리를 포함

int main(void)
{
    FILE* file; // 파일 포인터 선언
    char buffer[80]; // 파일에서 읽은 문자열을 저장할 버퍼

    file = fopen("example.txt", "r"); // 'example.txt' 파일을 읽기 모드로 연다
    if (file == NULL) // 파일 열기에 실패한 경우
    {
        printf("example.txt 파일이 없습니다. 생성합니다.\n");

        // 'example.txt' 파일을 쓰기 모드로 연다
        file = fopen("example.txt", "w");
        if (file == NULL) // 파일 생성에 실패한 경우
        {
            printf("파일 생성에 실패했습니다.\n");
            return 1; // 프로그램 종료 (1 반환)
        }

        // 파일에 문자열 작성
        fprintf(file, "예제 파일입니다.\n");
        fclose(file); // 파일을 닫는다

        // 다시 'example.txt' 파일을 읽기 모드로 연다
        file = fopen("example.txt", "r");
        if (file == NULL) // 파일 열기에 실패한 경우
        {
            printf("파일을 열지 못했습니다.\n");
            return 1; // 프로그램 종료 (1 반환)
        }
    }

    // 파일의 끝에 도달할 때까지 한 줄씩 읽어서 버퍼에 저장
    while (fgets(buffer, sizeof(buffer), file) != NULL)
    {
        printf("%s", buffer); // 읽은 줄을 출력
    }

    fclose(file); // 파일을 닫는다
    return 0; // 프로그램 종료 (0 반환)
}

example.txt 파일이 없습니다. 생성합니다.
예제 파일입니다.

예제: 파일 쓰기

C 언어를 사용하여 파일에 문자열을 작성하는 예제를 소개합니다.

코드: file_write.c

#define _CRT_SECURE_NO_WARNINGS // Visual Studio에서 보안 경고를 무시하도록 설정
#include <stdio.h>

int main(void)
{
    FILE* file; // 파일 포인터를 선언

    file = fopen("example.txt", "w"); // 'example.txt' 파일을 쓰기 모드로 연다
    if (file == NULL) // 파일 열기에 실패한 경우
    {
        printf("파일을 열지 못했습니다.\n");
        return 1; // 프로그램 종료 (1 반환)
    }

    fputs("안녕하세요.", file); // 파일에 문자열을 쓴다
    fclose(file); // 파일을 닫는다

    printf("파일 작성에 성공했습니다.\n"); // 작성 성공 메시지를 출력한다
    return 0; // 프로그램 종료 (0 반환)
}

파일 작성에 성공했습니다.

C 언어를 이용한 파일 존재 여부 확인

C 언어를 사용하여 프로그램에서 파일의 존재 여부를 확인하는 방법에 대해 설명하겠습니다. 이 예제에서는 fopen 함수를 사용하여 파일을 읽기 모드로 여는 시도를 하고, 파일이 열리지 않은 경우(NULL) 파일이 존재하지 않음을 사용자에게 알립니다.

코드 예제

아래 코드 예제는 example.txt 파일이 존재하는지 확인하는 C 프로그램입니다.

#define _CRT_SECURE_NO_WARNINGS // Visual Studio에서 보안 경고를 무시하도록 설정
#include <stdio.h>

int main(void)
{
    // 파일을 읽기 모드로 열기 시도
    FILE* file = fopen("example.txt", "r");

    // 파일이 열리지 않은 경우(NULL)
    if (file == NULL)
    {
        // 파일이 존재하지 않음을 사용자에게 알리고 종료
        printf("파일이 존재하지 않습니다.\n");
        return 1;
    }
    else
    {
        // 파일이 존재함을 사용자에게 알리고 파일을 닫은 후 종료
        printf("파일이 존재합니다.\n");
        fclose(file);
        return 0;
    }
}

파일이 존재합니다.

코드 설명

_CRT_SECURE_NO_WARNINGS 매크로를 정의하여, Visual Studio에서 발생하는 보안 경고를 무시하도록 설정합니다.
stdio.h 헤더 파일을 포함시켜 파일 입출력 관련 함수를 사용할 수 있도록 합니다.
main 함수에서 fopen 함수를 사용하여 example.txt 파일을 읽기 모드로 열기를 시도합니다. 파일을 열기에 성공하면 file 포인터 변수에 파일 포인터가 할당됩니다.
file 포인터 변수가 NULL인지 확인합니다. 만약 NULL이면, 파일이 존재하지 않음을 사용자에게 알리고 프로그램을 종료합니다.
파일이 존재하면, 사용자에게 파일이 존재함을 알리고, fclose 함수를 사용하여 파일을 닫은 후 프로그램을 종료합니다.

이 코드를 사용하면, 파일의 존재 여부를 간단하게 확인할 수 있습니다. 이러한 방법은 파일 시스템에서 특정 파일을 찾거나, 프로그램이 파일을 처리하기 전에 파일이 존재하는지 확인하는데 유용할 수 있습니다.

추천 자료: .NET Blazor에 대해 알아보시겠어요? .NET Blazor 알아보기를 확인해보세요!