HOWTO · C++

파일이 C++에 있는지 확인하는 방법

이 기사에서는 C++ 디렉토리에 파일이 있는지 확인하는 여러 방법을 소개합니다.

이 페이지의 내용

std::filesystem::exists는 경로가 가리키는 파일시스템 항목이 존재하는지 확인합니다. 파일과 디렉터리 모두에 대해 true를 반환합니다. 아래 예제는 확인할 대상이 명확하도록 임시 디렉터리와 파일을 만듭니다. 프로그램에서 확인하려는 경로에 맞게 file을 바꾸면 됩니다.

std::filesystem::exists를 사용해 디렉터리 안의 파일이 존재하는지 확인

다음 예제를 실행해 보세요.

#include <chrono>
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>

int main() {
  namespace fs = std::filesystem;
  const auto unique = std::chrono::steady_clock::now().time_since_epoch().count();
  const fs::path folder = fs::temp_directory_path() /
                          ("cpp-exists-" + std::to_string(unique));
  std::error_code ec;
  if (!fs::create_directory(folder, ec) || ec) {
    std::cout << "Could not prepare example\n";
    return 1;
  }

  struct cleanup_guard {
    fs::path path;
    ~cleanup_guard() {
      std::error_code cleanup_error;
      fs::remove_all(path, cleanup_error);
    }
  } cleanup{folder};

  const fs::path file = folder / "notes.txt";
  {
    std::ofstream output(file);
    if (!output) {
      std::cout << "Could not prepare example\n";
      return 1;
    }
  }

  std::cout << (fs::exists(file) ? "Path exists\n" : "Path does not exist\n");
  std::cout << (fs::is_regular_file(file) ? "It is a regular file\n"
                                          : "It is not a regular file\n");

}
Path exists
It is a regular file

fs::exists(file) 호출은 전달한 경로를 확인합니다. 같은 이름의 파일을 찾아다니지는 않습니다. 여기서 folder / "notes.txt"는 std::filesystem::path를 사용해 지정한 디렉터리와 파일 이름을 결합하며, 플랫폼에 맞는 경로 구분자를 처리합니다. 대상이 프로세스의 현재 작업 디렉터리 밖에 있다면, 이 방식으로 실제 디렉터리 경로를 지정하세요.

"notes.txt"와 같은 상대 경로는 프로그램의 실행 환경이 정한 프로세스의 현재 작업 디렉터리를 기준으로 해석됩니다. 실행 파일이 들어 있는 디렉터리를 기준으로 자동 해석되지는 않습니다. 현재 작업 디렉터리를 확인하려면 fs::current_path()를 호출하고, 프로세스의 작업 디렉터리를 바꾸려면 fs::current_path(path)를 사용한 뒤 보고된 파일시스템 오류를 처리하세요. 한 위치만 확인하면 된다면 알고 있는 디렉터리에서 경로를 만드는 편이 보통 더 명확합니다.

exists는 항목이 있는지 알려 주지만, 항목의 종류까지 알려 주지는 않습니다. 일반 파일만 대상으로 삼으려면 fs::is_regular_file(path)을 사용하고, 디렉터리를 예상한다면 fs::is_directory(path)를 사용하세요. 프로그램에 파일시스템 접근 권한이 없거나 확인 중에 경로가 바뀌면 이 검사로 유효한 답을 얻지 못할 수도 있습니다. 이런 경우를 구분해야 한다면 std::error_code를 받는 오버로드를 사용하고, 반환된 불리언 값과 오류를 따로 확인하세요.

예를 들어 std::error_code ec; const bool found = fs::exists(path, ec);를 사용하면 found와 ec를 모두 확인할 수 있습니다. 오류가 없으면서 결과가 false라면 경로를 찾지 못한 것이고, 오류가 설정되어 있다면 검사를 완료하지 못한 이유를 나타냅니다. 오류 코드 인자를 받지 않는 오버로드는 파일시스템 오류가 발생하면 예외를 던집니다. 예상 가능한 파일시스템 문제 이후에도 처리를 이어 가야 하는 코드에는 오류 코드 방식을 사용하고, 그렇지 않다면 예외를 던지는 방식으로 간단한 검사를 읽기 쉽게 유지할 수 있습니다. 검사 후 파일을 여는 사이에 경로가 다른 항목을 가리키게 될 수도 있으므로, 검사 결과를 조회 시점의 답으로만 사용하고 이후 작업의 성공을 보장한다고 여기지 마세요.

예제는 std::filesystem을 사용하며 자체 임시 파일과 디렉터리를 만듭니다. 디렉터리나 파일을 준비하지 못하면 준비 오류 메시지를 출력하고 0이 아닌 상태 코드를 반환합니다. 정리 가드는 정상적으로 종료할 때 임시 디렉터리 제거를 시도하며, 정리 중 발생한 오류는 무시합니다. 조회에는 예외를 던지는 오버로드를 사용하므로, 처리되지 않은 파일시스템 예외가 main 밖으로 전파되면 프로그램이 종료될 수 있고 정리 가드의 소멸자가 실행된다고 보장할 수 없습니다. 정상 경로에서는 위에 표시된 두 줄이 출력됩니다. 출력 블록의 레이블은 바이트 그대로 유지되므로 영어로 표시됩니다.