MENU
  1. ホーム
  2. C 언어
  3. C언어에서 디렉터리 읽기를 위한 opendir(), readdir(), closedir() 완벽 가이드

C언어에서 디렉터리 읽기를 위한 opendir(), readdir(), closedir() 완벽 가이드

C 언어

C 언어에서 디렉터리 구조를 다루는 것은 파일 시스템 작업의 핵심입니다. 디렉터리 안의 파일 목록을 읽고 처리하기 위해 opendir(), readdir(), closedir() 함수가 자주 사용됩니다. 이 함수들은 POSIX 표준에 기반하여 디렉터리를 열고 항목을 읽은 뒤 닫는 과정을 간단하고 효율적으로 처리할 수 있게 해줍니다. 본 기사에서는 이러한 함수들의 기본 사용법부터 실전 예제까지 단계별로 설명하여, 디렉터리 작업을 처음 접하는 개발자도 쉽게 따라 할 수 있도록 돕겠습니다.

다음 항목을 지시해 주세요!

목차
  1. 디렉터리 읽기 개념
    1. 디렉터리와 파일의 차이
    2. 디렉터리 읽기의 필요성
    3. 디렉터리 읽기 프로세스
  2. opendir() 함수의 역할과 사용법
    1. opendir() 함수 개요
    2. opendir() 사용법
    3. opendir()의 동작
    4. opendir() 사용 시 주의사항
  3. readdir() 함수로 디렉터리 항목 읽기
    1. readdir() 함수 개요
    2. struct dirent 구조체
    3. readdir() 사용법
    4. readdir()의 동작
    5. readdir() 사용 시 주의사항
  4. closedir() 함수로 리소스 해제하기
    1. closedir() 함수 개요
    2. closedir() 사용법
    3. closedir()의 역할
    4. closedir() 사용 시 주의사항
    5. 리소스 관리의 중요성
  5. 디렉터리 읽기 응용: 파일 목록 출력
    1. 예제 프로그램: 디렉터리 내 파일 및 디렉터리 목록 출력
    2. 코드 설명
    3. 실행 결과
    4. 응용: 특정 파일 유형 필터링
    5. 응용 시나리오
  6. 예외 처리 및 오류 디버깅
    1. opendir() 함수의 오류 처리
    2. readdir() 함수의 오류 처리
    3. closedir() 함수의 오류 처리
    4. 특수 상황 처리
    5. 디버깅 팁
    6. 종합적인 예외 처리 예제
  7. 플랫폼 별 디렉터리 읽기 차이
    1. POSIX 기반 플랫폼(Linux 및 macOS)
    2. Windows 플랫폼
    3. 플랫폼 간 주요 차이점
    4. 플랫폼 독립적인 코드 작성
    5. 호환성 체크 시 주의사항
  8. 요약

디렉터리 읽기 개념


디렉터리는 파일 시스템에서 파일과 다른 디렉터리를 조직적으로 정리하는 기본 단위입니다. 디렉터리 읽기는 파일 시스템 구조를 탐색하거나 특정 파일을 찾을 때 자주 사용됩니다.

디렉터리와 파일의 차이


파일은 데이터 저장의 기본 단위로, 내용이 포함된 실질적인 데이터 객체입니다. 반면, 디렉터리는 파일 및 다른 디렉터리를 포함할 수 있는 “컨테이너” 역할을 하며, 파일 시스템 내에서 경로를 정의합니다.

디렉터리 읽기의 필요성

  1. 파일 탐색: 특정 디렉터리 내에 어떤 파일이 있는지 알아보기 위함.
  2. 작업 자동화: 예를 들어, 특정 확장자를 가진 파일을 처리하거나 백업 작업을 자동화할 때.
  3. 데이터 관리: 파일 정리 및 분석을 효율적으로 수행.

디렉터리 읽기 프로세스


디렉터리를 읽는 작업은 일반적으로 세 가지 단계로 진행됩니다.

  1. 디렉터리 열기: opendir() 함수를 사용하여 디렉터리 스트림을 엽니다.
  2. 항목 읽기: readdir() 함수를 사용하여 디렉터리의 각 항목(파일 또는 하위 디렉터리)을 하나씩 읽습니다.
  3. 디렉터리 닫기: closedir() 함수를 사용하여 디렉터리 스트림을 닫아 리소스를 해제합니다.

이러한 개념을 바탕으로 다음 섹션에서는 opendir(), readdir(), closedir() 함수의 구체적인 역할과 사용법을 살펴보겠습니다.

opendir() 함수의 역할과 사용법

opendir() 함수는 디렉터리를 열어 작업을 시작하는 첫 단계에서 사용됩니다. 이 함수는 지정된 경로의 디렉터리를 열고, 이를 조작할 수 있는 디렉터리 스트림 포인터를 반환합니다.

opendir() 함수 개요

  • 헤더 파일: <dirent.h>
  • 함수 원형:
  DIR *opendir(const char *name);
  • 매개변수:
  • name: 디렉터리 경로를 나타내는 문자열.
  • 반환값:
  • 성공 시: 디렉터리 스트림에 대한 포인터(DIR*).
  • 실패 시: NULL(오류는 errno에 설정).

opendir() 사용법


다음은 opendir() 함수를 사용하여 디렉터리를 여는 기본 예제입니다:

#include <stdio.h>
#include <dirent.h>

int main() {
    const char *path = "./";
    DIR *dir = opendir(path);

    if (dir == NULL) {
        perror("opendir");
        return 1;
    }

    printf("디렉터리 '%s'를 성공적으로 열었습니다.\n", path);

    // 디렉터리 스트림 사용 후에는 반드시 닫아야 합니다.
    closedir(dir);
    return 0;
}

opendir()의 동작

  1. 디렉터리 경로를 확인하고 디렉터리가 존재하는지 검사.
  2. 디렉터리가 유효하고 읽기 권한이 있으면 디렉터리 스트림을 생성.
  3. 디렉터리 스트림에 대한 포인터를 반환하여 이후 작업(예: 항목 읽기)에 사용 가능.

opendir() 사용 시 주의사항

  1. NULL 반환 처리: 디렉터리가 없거나 권한 문제가 있는 경우 NULL을 반환하며, 오류는 perror()로 출력 가능.
  2. 파일 경로 사용 금지: 파일 경로를 opendir()에 전달하면 오류가 발생합니다.
  3. 리소스 관리: 디렉터리 스트림을 열었으면 반드시 closedir()로 닫아야 메모리 누수를 방지할 수 있습니다.

다음 섹션에서는 열린 디렉터리 스트림에서 항목을 읽는 readdir() 함수에 대해 알아보겠습니다.

readdir() 함수로 디렉터리 항목 읽기

readdir() 함수는 디렉터리 스트림에서 각 항목(파일 또는 하위 디렉터리)을 순차적으로 읽어오는 역할을 합니다. 이를 통해 디렉터리 내의 파일과 디렉터리 목록을 탐색할 수 있습니다.

readdir() 함수 개요

  • 헤더 파일: <dirent.h>
  • 함수 원형:
  struct dirent *readdir(DIR *dirp);
  • 매개변수:
  • dirp: opendir() 함수로 반환된 디렉터리 스트림 포인터.
  • 반환값:
  • 성공 시: 디렉터리 항목 정보를 담은 struct dirent 포인터.
  • 디렉터리 끝에 도달하거나 오류 발생 시: NULL.

struct dirent 구조체


readdir()의 반환값은 디렉터리 항목 정보를 담고 있는 struct dirent입니다. 주요 필드는 다음과 같습니다:

struct dirent {
    ino_t          d_ino;       // 파일의 inode 번호
    char           d_name[];    // 파일 또는 디렉터리 이름
};

readdir() 사용법


다음은 readdir()를 사용하여 디렉터리 항목을 읽는 간단한 예제입니다:

#include <stdio.h>
#include <dirent.h>

int main() {
    const char *path = "./";
    DIR *dir = opendir(path);

    if (dir == NULL) {
        perror("opendir");
        return 1;
    }

    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        printf("파일/디렉터리 이름: %s\n", entry->d_name);
    }

    closedir(dir);
    return 0;
}

readdir()의 동작

  1. readdir()를 호출할 때마다 디렉터리의 다음 항목을 읽음.
  2. 반환된 struct dirent 포인터를 통해 파일 이름(d_name)에 접근.
  3. 디렉터리 끝에 도달하면 NULL 반환.

readdir() 사용 시 주의사항

  1. 항목 순서 보장 없음: 항목의 반환 순서는 파일 시스템에 따라 다를 수 있습니다. 정렬이 필요하다면 추가 작업이 필요합니다.
  2. 특수 항목 처리: 디렉터리에는 "."(현재 디렉터리)와 ".."(부모 디렉터리)가 포함될 수 있으므로 이를 필터링해야 할 때가 있습니다.

예제:

if (entry->d_name[0] == '.') {
    continue; // 숨김 항목 무시
}

다음 섹션에서는 디렉터리 스트림을 닫고 시스템 리소스를 해제하는 closedir() 함수에 대해 알아보겠습니다.

closedir() 함수로 리소스 해제하기

closedir() 함수는 열려 있는 디렉터리 스트림을 닫아 시스템 리소스를 해제하는 데 사용됩니다. 디렉터리를 열고 작업을 완료한 후 반드시 호출하여 리소스 누수를 방지해야 합니다.

closedir() 함수 개요

  • 헤더 파일: <dirent.h>
  • 함수 원형:
  int closedir(DIR *dirp);
  • 매개변수:
  • dirp: opendir() 함수로 반환된 디렉터리 스트림 포인터.
  • 반환값:
  • 성공 시: 0.
  • 실패 시: -1(오류는 errno에 설정).

closedir() 사용법


다음은 closedir()를 사용하여 디렉터리 스트림을 닫는 간단한 예제입니다:

#include <stdio.h>
#include <dirent.h>

int main() {
    const char *path = "./";
    DIR *dir = opendir(path);

    if (dir == NULL) {
        perror("opendir");
        return 1;
    }

    // 디렉터리 작업 수행
    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        printf("파일/디렉터리 이름: %s\n", entry->d_name);
    }

    // 디렉터리 스트림 닫기
    if (closedir(dir) == -1) {
        perror("closedir");
        return 1;
    }

    printf("디렉터리를 성공적으로 닫았습니다.\n");
    return 0;
}

closedir()의 역할

  1. 디렉터리 스트림 포인터를 해제하여 메모리와 파일 시스템 리소스를 반환.
  2. 열린 디렉터리 스트림이 더 이상 사용되지 않도록 방지.

closedir() 사용 시 주의사항

  1. 반드시 호출: 디렉터리 스트림을 닫지 않으면 메모리 누수가 발생할 수 있습니다.
  2. NULL 포인터에 대한 호출 금지: NULL 포인터를 전달하면 정의되지 않은 동작이 발생할 수 있습니다.
  3. 오류 처리: closedir() 호출이 실패하는 경우(예: 파일 시스템 문제가 발생했을 때) 이를 처리해야 합니다.

리소스 관리의 중요성


디렉터리 작업을 수행할 때 opendir()와 readdir()만큼 closedir()의 호출도 중요합니다. 특히 긴 시간 동안 여러 디렉터리를 처리하는 프로그램에서는 리소스 누수가 성능 저하나 예기치 않은 오류를 초래할 수 있습니다.

다음 섹션에서는 이 함수들을 활용한 간단한 디렉터리 읽기 응용 예제를 소개하겠습니다.

디렉터리 읽기 응용: 파일 목록 출력

opendir(), readdir(), closedir() 함수를 조합하면 특정 디렉터리 내의 파일 및 디렉터리 목록을 출력하는 간단한 프로그램을 작성할 수 있습니다. 이를 통해 디렉터리 작업의 기본 흐름을 이해할 수 있습니다.

예제 프로그램: 디렉터리 내 파일 및 디렉터리 목록 출력


다음 코드는 지정된 디렉터리의 항목을 읽어 화면에 출력하는 간단한 예제입니다:

#include <stdio.h>
#include <dirent.h>
#include <string.h>

int main() {
    const char *path = "./"; // 읽을 디렉터리 경로
    DIR *dir = opendir(path);

    if (dir == NULL) {
        perror("opendir");
        return 1;
    }

    printf("디렉터리 '%s'의 항목 목록:\n", path);

    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        // '.'와 '..' 제외
        if (strcmp(entry->d_name, ".") == 0 || strcmp(entry->d_name, "..") == 0) {
            continue;
        }

        printf(" - %s\n", entry->d_name);
    }

    if (closedir(dir) == -1) {
        perror("closedir");
        return 1;
    }

    return 0;
}

코드 설명

  1. 디렉터리 열기: opendir()로 디렉터리 스트림을 엽니다.
  2. 항목 읽기: readdir()로 디렉터리 항목을 하나씩 읽습니다.
  3. 특수 항목 필터링: "."와 ".."는 현재 디렉터리와 부모 디렉터리를 의미하므로 이를 제외.
  4. 목록 출력: entry->d_name을 사용하여 항목 이름을 출력.
  5. 리소스 해제: closedir()로 디렉터리 스트림을 닫습니다.

실행 결과


예를 들어, 디렉터리에 다음 항목이 있다고 가정합니다:

file1.txt  
file2.txt  
subdir

프로그램 실행 시 출력:

디렉터리 './'의 항목 목록:  
 - file1.txt  
 - file2.txt  
 - subdir

응용: 특정 파일 유형 필터링


다음은 .txt 확장자를 가진 파일만 출력하는 코드입니다:

if (strstr(entry->d_name, ".txt") != NULL) {
    printf(" - %s\n", entry->d_name);
}

응용 시나리오

  1. 백업 시스템: 특정 디렉터리의 파일 목록을 읽어 백업 처리.
  2. 검색 도구: 파일 이름에 특정 키워드가 포함된 파일 탐색.
  3. 보고서 생성: 디렉터리 구조를 텍스트 파일로 저장.

다음 섹션에서는 디렉터리 작업에서 발생할 수 있는 오류와 이를 처리하는 방법에 대해 설명하겠습니다.

예외 처리 및 오류 디버깅

디렉터리 읽기 과정에서 다양한 예외 상황이 발생할 수 있습니다. 이러한 오류를 효과적으로 처리하고 디버깅하는 것은 안정적인 프로그램 작성의 핵심입니다.

opendir() 함수의 오류 처리


opendir() 함수가 실패할 경우 NULL을 반환하며, 실패 원인은 errno 변수에 설정됩니다. 이를 perror()나 strerror()를 통해 확인할 수 있습니다.
예제:

DIR *dir = opendir("./nonexistent");
if (dir == NULL) {
    perror("opendir 실패");
    return 1;
}

가능한 오류 원인:

  • 디렉터리가 존재하지 않음: ENOENT
  • 권한 부족: EACCES
  • 파일 경로가 디렉터리가 아님: ENOTDIR

readdir() 함수의 오류 처리


readdir() 함수는 디렉터리의 끝에 도달하면 NULL을 반환합니다. 하지만 오류가 발생한 경우에도 NULL을 반환하므로, 이를 구별하기 위해 errno를 확인해야 합니다.
예제:

struct dirent *entry;
while ((entry = readdir(dir)) != NULL) {
    // 디렉터리 항목 읽기
}

if (errno != 0) {
    perror("readdir 오류");
}

closedir() 함수의 오류 처리


closedir() 함수가 실패하면 -1을 반환하며, 오류 원인은 errno에 설정됩니다.
예제:

if (closedir(dir) == -1) {
    perror("closedir 실패");
}

특수 상황 처리

  1. 빈 디렉터리 처리
  • readdir() 호출에서 바로 NULL이 반환될 수 있습니다.
  • 예:
    c if ((entry = readdir(dir)) == NULL) { printf("디렉터리가 비어 있습니다.\n"); }
  1. 숨김 파일 처리
  • 파일 이름이 "." 또는 ".."로 시작하면 이를 무시해야 할 경우가 많습니다.
  • 예:
    c if (entry->d_name[0] == '.') { continue; // 숨김 파일 제외 }
  1. 권한 문제
  • 읽기 권한이 없는 디렉터리를 열려고 하면 EACCES 오류가 발생합니다. 이를 사용자에게 알리거나 로그에 기록.

디버깅 팁

  1. 로그 추가
  • 각 함수 호출 전에 경로 및 함수명을 출력하여 디버깅 용이.
  1. gdb 사용
  • 디렉터리 읽기 관련 오류를 디버깅할 때 유용.
  1. 테스트 케이스 생성
  • 존재하지 않는 디렉터리, 권한 없는 디렉터리 등 다양한 시나리오를 테스트.

종합적인 예외 처리 예제

#include <stdio.h>
#include <dirent.h>
#include <errno.h>

int main() {
    const char *path = "./";
    DIR *dir = opendir(path);

    if (dir == NULL) {
        perror("opendir 실패");
        return 1;
    }

    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        if (entry->d_name[0] == '.') continue; // 숨김 항목 제외
        printf("항목: %s\n", entry->d_name);
    }

    if (errno != 0) {
        perror("readdir 실패");
        closedir(dir);
        return 1;
    }

    if (closedir(dir) == -1) {
        perror("closedir 실패");
        return 1;
    }

    printf("디렉터리 작업 완료.\n");
    return 0;
}

다음 섹션에서는 플랫폼별 디렉터리 작업의 차이점과 호환성을 고려한 코드 작성 방법에 대해 알아보겠습니다.

플랫폼 별 디렉터리 읽기 차이

디렉터리 작업은 운영 체제에 따라 동작 방식이나 사용 가능한 함수에 차이가 있습니다. 이러한 차이를 이해하면, 여러 플랫폼에서 동작하는 호환성 높은 코드를 작성할 수 있습니다.

POSIX 기반 플랫폼(Linux 및 macOS)


POSIX 표준을 따르는 운영 체제에서는 <dirent.h> 헤더 파일에 정의된 opendir(), readdir(), closedir() 함수를 사용하여 디렉터리를 읽습니다.

  • 특징:
  • API가 표준화되어 있어 대부분의 Unix 계열 시스템에서 동일한 코드로 작동.
  • 디렉터리와 파일 구분 없이 항목 이름만 반환.
  • 파일의 상세 정보를 얻으려면 추가적인 시스템 호출(stat() 등)이 필요.

예제:

#include <dirent.h>
DIR *dir = opendir("./");
if (dir != NULL) {
    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        printf("%s\n", entry->d_name);
    }
    closedir(dir);
}

Windows 플랫폼


Windows에서는 POSIX 스타일 함수 대신 WinAPI 함수를 사용하여 디렉터리를 읽습니다. 주요 함수는 다음과 같습니다:

  • FindFirstFile(): 디렉터리에서 첫 번째 항목 검색.
  • FindNextFile(): 다음 항목 검색.
  • FindClose(): 디렉터리 스트림 닫기.

Windows에서의 예제:

#include <windows.h>
#include <tchar.h>

int main() {
    WIN32_FIND_DATA findFileData;
    HANDLE hFind = FindFirstFile(TEXT("./*"), &findFileData);

    if (hFind == INVALID_HANDLE_VALUE) {
        _tprintf(TEXT("FindFirstFile 실패: %d\n"), GetLastError());
        return 1;
    } 

    do {
        _tprintf(TEXT("항목: %s\n"), findFileData.cFileName);
    } while (FindNextFile(hFind, &findFileData) != 0);

    FindClose(hFind);
    return 0;
}

플랫폼 간 주요 차이점

항목POSIX (Linux/macOS)Windows
주요 헤더 파일<dirent.h><windows.h>
디렉터리 열기opendir()FindFirstFile()
항목 읽기readdir()FindNextFile()
디렉터리 닫기closedir()FindClose()
숨김 파일 포함 여부디폴트 포함FILE_ATTRIBUTE_HIDDEN로 필터링 가능.

플랫폼 독립적인 코드 작성


플랫폼 간 호환성을 유지하려면 컴파일러와 운영 체제를 감지하여 조건부 컴파일을 사용하는 것이 일반적입니다.
예제:

#ifdef _WIN32
#include <windows.h>
#else
#include <dirent.h>
#endif

void list_directory(const char *path) {
#ifdef _WIN32
    WIN32_FIND_DATA findFileData;
    HANDLE hFind = FindFirstFile(path, &findFileData);

    if (hFind == INVALID_HANDLE_VALUE) {
        printf("디렉터리를 열 수 없습니다.\n");
        return;
    }

    do {
        printf("%s\n", findFileData.cFileName);
    } while (FindNextFile(hFind, &findFileData) != 0);

    FindClose(hFind);
#else
    DIR *dir = opendir(path);
    if (dir == NULL) {
        perror("opendir");
        return;
    }

    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        printf("%s\n", entry->d_name);
    }

    closedir(dir);
#endif
}

호환성 체크 시 주의사항

  1. 파일 경로 표기
  • Windows: 백슬래시(\) 사용.
  • POSIX: 슬래시(/) 사용.
  • 해결책: 슬래시(/)를 사용하면 대부분의 Windows 환경에서도 작동.
  1. 문자열 처리
  • Windows: 유니코드(WCHAR)와 멀티바이트(CHAR) 문자열 차이 고려.
  1. 숨김 파일 처리
  • POSIX: "."으로 시작하는 파일.
  • Windows: FILE_ATTRIBUTE_HIDDEN 속성 확인.

플랫폼 간 차이를 이해하고 위와 같은 방식으로 조건부 컴파일을 사용하면, 다중 운영 체제를 지원하는 디렉터리 읽기 코드를 작성할 수 있습니다.

다음 섹션에서는 지금까지 다룬 내용을 요약하며 마무리하겠습니다.

요약

C 언어에서 디렉터리 읽기를 처리하는 opendir(), readdir(), closedir() 함수는 파일 시스템 작업의 기본 도구입니다. 본 기사에서는 디렉터리 읽기의 개념부터 각 함수의 역할과 사용법, 응용 예제까지 다뤘습니다.
또한, 예외 처리와 플랫폼 간 차이를 이해하고 조건부 컴파일을 활용하여 호환성 높은 코드를 작성하는 방법을 살펴보았습니다.

디렉터리 읽기 작업은 파일 탐색, 데이터 관리, 자동화된 프로세스에서 중요한 역할을 하며, 이를 적절히 구현하면 안정적이고 효율적인 프로그램을 개발할 수 있습니다.

C 언어
C언어 디렉터리읽기 파일시스템
목차
  1. 디렉터리 읽기 개념
    1. 디렉터리와 파일의 차이
    2. 디렉터리 읽기의 필요성
    3. 디렉터리 읽기 프로세스
  2. opendir() 함수의 역할과 사용법
    1. opendir() 함수 개요
    2. opendir() 사용법
    3. opendir()의 동작
    4. opendir() 사용 시 주의사항
  3. readdir() 함수로 디렉터리 항목 읽기
    1. readdir() 함수 개요
    2. struct dirent 구조체
    3. readdir() 사용법
    4. readdir()의 동작
    5. readdir() 사용 시 주의사항
  4. closedir() 함수로 리소스 해제하기
    1. closedir() 함수 개요
    2. closedir() 사용법
    3. closedir()의 역할
    4. closedir() 사용 시 주의사항
    5. 리소스 관리의 중요성
  5. 디렉터리 읽기 응용: 파일 목록 출력
    1. 예제 프로그램: 디렉터리 내 파일 및 디렉터리 목록 출력
    2. 코드 설명
    3. 실행 결과
    4. 응용: 특정 파일 유형 필터링
    5. 응용 시나리오
  6. 예외 처리 및 오류 디버깅
    1. opendir() 함수의 오류 처리
    2. readdir() 함수의 오류 처리
    3. closedir() 함수의 오류 처리
    4. 특수 상황 처리
    5. 디버깅 팁
    6. 종합적인 예외 처리 예제
  7. 플랫폼 별 디렉터리 읽기 차이
    1. POSIX 기반 플랫폼(Linux 및 macOS)
    2. Windows 플랫폼
    3. 플랫폼 간 주요 차이점
    4. 플랫폼 독립적인 코드 작성
    5. 호환성 체크 시 주의사항
  8. 요약