[c++] 디렉토리 내의 파일 찾기 FindFirstFile() 함수

특정 디렉토리 아래에 있는 모든 파일과 디렉토리 혹은 특정 조건의 파일과 디렉토리를 얻고자 한다면, 다음 API 함수를 이용한다.

HANDLE FindFirstFile(LPCSTR lpFileName, LPWIN32_FIND_DATA finddata);

BOOL FindNextFile(HANDLE hFind, LPWIN32_FIND_DATA finddata);

BOOL FindClose(HANDLE hFind);

FindFirstFile : 파일 검색을 시작한다.

파일 검색 문자열이 잘못되었거나 다른 이유로 함수 실행이 실패했을 경우 INVALID_HANDLE_VALUE로 Define된 상수값을 반환한다. 성공했을 경우 파일 검색 핸들을 반환하고 두 번째로 전달되는 구조체에 첫 번째로 발견되는 파일의 정보를 넣어준다.

LPCSTR lpFileName

파일 검색 문자열을 넘겨준다.

예) "c:*.*" 혹은 "c:*.txt"

LPWIN32_FIND_DATA finddata

파일 검색 데이터 구조체의 포인터를 넘겨준다.

FindNextFile : 다음 파일의 정보를 얻는다.

함수 실행이 성공하였을 경우 TRUE를, 실패하였을 경우 FALSE를 반환한다. 함수 성공시 두 번째 인자로 전해지는 구조체에 파일의 정보를 넣어준다.

HANDLE hFind

FindFirstFile이 반환한 파일 검색 핸들을 넘겨준다.

LPWIN32_FIND_DATA finddata

파일 검색 데이터 구조체의 포인터를 넘겨준다.

FileClose : 파일 핸들을 닫는다.

FindFirstFile에 의해 열린 파일 핸들을 닫는다. 성공하였을 경우 TRUE를, 실패하였을 경우 FALSE를 반환한다.

HANDLE hFind

FindFirstFile이 반환한 파일 검색 핸들을 넘겨준다.

사용 예

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

int main()
{
    WIN32_FIND_DATA FindData;
    HANDLE hFind;
    char path[255];

    strcpy(path, "c:windows*");
    
    hFind = FindFirstFile((LPCSTR)path, &FindData);
    if(hFind==INVALID_HANDLE_VALUE)
        return 0;
    
    do{
        printf("%s
", FindData.cFileName);
    }while(FindNextFile(hFind, &FindData));

    FindClose(hFind);

    return 0;
}

[c++] 디렉토리 내의 파일 찾기 FindFirstFile() 함수

단축키

Articles