C++ File Status | "파일 상태" 가이드

파일 상태란?

C++17 filesystem에서 파일의 존재 여부뿐 아니라 일반 파일·디렉터리·심볼릭 링크 여부와 권한을 구분하려면 file_status를 이해하는 것이 좋습니다. 이 글을 따라가면 메타데이터 조회 흐름과 이후 절의 타입별 API를 자연스럽게 연결할 수 있습니다.

파일 메타데이터 조회 (C++17)

#include <filesystem>

namespace fs = std::filesystem;

fs::path p = "file.txt";
auto status = fs::status(p);

if (status.type() == fs::file_type::regular) {
    std::cout << "일반 파일" << std::endl;
}

파일 타입

fs::file_type type = fs::status(p).type();

// 타입 확인
fs::is_regular_file(p);
fs::is_directory(p);
fs::is_symlink(p);
fs::is_block_file(p);
fs::is_character_file(p);
fs::is_fifo(p);
fs::is_socket(p);

실전 예시

예시 1: 파일 정보

void printFileInfo(const fs::path& p) {
    if (!fs::exists(p)) {
        std::cout << "파일 없음" << std::endl;
        return;
    }
    
    auto status = fs::status(p);
    
    std::cout << "경로: " << p << std::endl;
    std::cout << "타입: ";
    
    if (fs::is_regular_file(status)) {
        std::cout << "일반 파일" << std::endl;
        std::cout << "크기: " << fs::file_size(p) << " bytes" << std::endl;
    } else if (fs::is_directory(status)) {
        std::cout << "디렉토리" << std::endl;
    } else if (fs::is_symlink(status)) {
        std::cout << "심볼릭 링크" << std::endl;
    }
}

예시 2: 수정 시간

void printModifiedTime(const fs::path& p) {
    auto ftime = fs::last_write_time(p);
    
    // C++20: system_clock 변환
    auto sctp = std::chrono::time_point_cast<std::chrono::system_clock::duration>(
        ftime - fs::file_time_type::clock::now() + 
        std::chrono::system_clock::now()
    );
    
    std::time_t cftime = std::chrono::system_clock::to_time_t(sctp);
    std::cout << "수정: " << std::ctime(&cftime);
}

예시 3: 권한 확인

void checkPermissions(const fs::path& p) {
    auto perms = fs::status(p).permissions();
    
    std::cout << "권한: ";
    
    if ((perms & fs::perms::owner_read) != fs::perms::none) {
        std::cout << "r";
    }
    if ((perms & fs::perms::owner_write) != fs::perms::none) {
        std::cout << "w";
    }
    if ((perms & fs::perms::owner_exec) != fs::perms::none) {
        std::cout << "x";
    }
    
    std::cout << std::endl;
}

예시 4: 공간 정보

void printSpaceInfo(const fs::path& p) {
    auto space = fs::space(p);
    
    std::cout << "용량: " << space.capacity << " bytes" << std::endl;
    std::cout << "여유: " << space.free << " bytes" << std::endl;
    std::cout << "사용 가능: " << space.available << " bytes" << std::endl;
}

권한 설정

fs::path p = "file.txt";

// 권한 추가
fs::permissions(p, fs::perms::owner_write, 
                fs::perm_options::add);

// 권한 제거
fs::permissions(p, fs::perms::owner_write,
                fs::perm_options::remove);

// 권한 설정
fs::permissions(p, fs::perms::owner_all);

file_status와 perms

std::filesystem::file_status는 한 번의 조회 결과를 담는 값입니다. 주로 다음 두 가지를 묶습니다.

• type() → file_type: regular, directory, symlink, not_found 등. 심볼릭 링크를 따라가지 않은 상태는 symlink_status로, 따라간 결과는 status로 얻는 패턴이 자주 쓰입니다.
• permissions() → perms: 소유자·그룹·기타에 대한 읽기/쓰기/실행 비트. none과 비트 AND로 “설정 여부”를 확인합니다.

fs::file_status st = fs::status(p, ec);
if (!ec && st.type() != fs::file_type::not_found) {
    auto pm = st.permissions();
    bool owner_read = (pm & fs::perms::owner_read) != fs::perms::none;
}

status(p)는 심볼릭 링크의 최종 타겟을 조회하고, 링크 자체의 타입이 필요하면 symlink_status(p)를 씁니다. 깨진 링크는 status가 not_found가 될 수 있어, 먼저 symlink_status로 링크인지 구분하는 편이 디버깅에 유리합니다.

파일 타입 확인 (정리)

file_type은 unknown, none, not_found 같은 “정보 부족” 상태도 구분합니다. 실무에서는 보통 편의 함수를 함께 씁니다.

목적	권장 API
일반 파일 여부	fs::is_regular_file(st) 또는 is_regular_file(p)
디렉터리 여부	fs::is_directory(st)
심볼릭 링크 여부	fs::is_symlink(st) — symlink_status 기반
블록/문자 장치 등	is_block_file, is_character_file, is_fifo, is_socket

auto st = fs::status(path);
if (fs::is_regular_file(st)) { /* … */ }
else if (fs::is_directory(st)) { /* … */ }

auto lst = fs::symlink_status(path);
if (fs::is_symlink(lst)) {
    auto target_st = fs::status(path); // 링크를 따라간 대상
}

주의: 경로가 존재하지 않으면 type()이 not_found이고, exists(path)는 false입니다. is_regular_file은 존재하지 않으면 false를 돌려주므로, “없는 파일”과 “있지만 디렉터리”를 구분하려면 status와 file_type을 함께 보는 것이 안전합니다.

권한 검사

perms는 POSIX 스타일 비트 마스크를 가능한 한 추상화한 것입니다. 실행 권한이 없는 일반 파일, 디렉터리의 실행 비트(탐색 허용) 등 OS 의미는 문서와 실제 환경에서 확인하는 것이 좋습니다.

bool can_owner_write(const fs::path& p, std::error_code& ec) {
    auto st = fs::status(p, ec);
    if (ec) return false;
    auto pm = st.permissions();
    return (pm & fs::perms::owner_write) != fs::perms::none;
}

// 소유자 rwx를 한 줄로 출력하는 예 (POSIX 스타일)
void print_owner_rwx(fs::perms pm) {
    char r = (pm & fs::perms::owner_read) != fs::perms::none ? 'r' : '-';
    char w = (pm & fs::perms::owner_write) != fs::perms::none ? 'w' : '-';
    char x = (pm & fs::perms::owner_exec) != fs::perms::none ? 'x' : '-';
    std::cout << r << w << x;
}

쓰기 전 검사 예:

std::error_code ec;
if (can_owner_write(path, ec)) {
    // 덮어쓰기 등
}

Windows: 읽기 전용 속성·ACL은 filesystem의 perms와 1:1로 대응하지 않을 수 있습니다. 크로스 플랫폼 도구라면 “실패 시 permissions 재시도”보다 실제 open/ofstream 실패를 처리하는 쪽이 신뢰도가 높은 경우가 많습니다.

실전: 백업 스크립트 (개념)

“최근 N일 수정된 파일만 복사” 같은 백업은 **last_write_time과 file_status**로 대상을 고릅니다. 대용량 트리는 recursive_directory_iterator와 조합합니다.

namespace fs = std::filesystem;
using clock = fs::file_time_type::clock;

bool needs_backup(const fs::path& p,
                  fs::file_time_type cutoff,
                  std::error_code& ec) {
    auto st = fs::status(p, ec);
    if (ec || !fs::is_regular_file(st)) return false;
    auto mtime = fs::last_write_time(p, ec);
    if (ec) return false;
    return mtime >= cutoff;
}

cutoff는 “지금 − 7일” 등을 file_time_type으로 변환한 값입니다. C++20에서는 clock::now()와의 차로 비교하기 쉬워집니다. 복사 시에는 **equivalent**로 동일 inode(하드 링크) 여부를 참고해 중복 복사를 줄일 수 있습니다.

실전: 로그 관리 (로테이션·정리)

오래된 로그 삭제는 일반 파일 + 수정 시각으로 결정합니다. C++17에서는 file_time_type과 시계 변환이 구현체마다 달라서, 기준 시각 하나를 file_time_type으로 만들어 두고 항목마다 last_write_time과 비교하는 방식이 안전합니다.

void prune_old_logs(const fs::path& log_dir,
                    fs::file_time_type cutoff,
                    std::error_code& ec) {
    for (const auto& e : fs::directory_iterator(log_dir, ec)) {
        if (ec) break;
        if (!e.is_regular_file()) continue;
        auto mt = fs::last_write_time(e.path(), ec);
        if (ec) continue;
        if (mt < cutoff) {
            fs::remove(e.path(), ec);
        }
    }
}
// cutoff는 "지금 기준 7일 전" 등을 동일한 clock으로 맞춰 만든 값이어야 합니다.
// C++20 `std::chrono::file_clock`이 있으면 변환·비교가 더 명확해집니다.

디스크 임계치는 앞서 본 fs::space로 볼륨 여유를 확인한 뒤, 가장 오래된 로그부터 지우는 식으로 정책을 이중화하는 것이 안전합니다.

플랫폼별 차이

주제	POSIX (Linux, macOS)	Windows
권한 비트	전통적 rwx, chmod와 유사한 모델	perms는 단순화·에뮬; ACL·속성은 별도
경로 구분자	/	\와 / 모두 허용되나 표시는 \인 경우 많음
심볼릭 링크	널리 사용	관리자 권한·개발자 모드 등 환경 의존
대소문자	대개 구분	기본적으로 경로 비교 시 대소문자 무시에 가까움

실무 권장: 크로스 플랫폼 코드는 fs::path 연산을 쓰고, 권한은 “perms로 힌트를 얻되, 최종은 I/O 실패 처리”로 보완합니다. 배포 스크립트는 OS별로 permissions 호출을 분기하거나 문서에 한정할 수 있습니다.

자주 발생하는 문제

문제 1: 존재 확인

// ❌ 존재 확인 없이
auto size = fs::file_size("file.txt");  // 예외

// ✅ 존재 확인
if (fs::exists("file.txt")) {
    auto size = fs::file_size("file.txt");
}

문제 2: 디렉토리 크기

// ❌ 디렉토리에 file_size
// auto size = fs::file_size("dir");  // 예외

// ✅ 재귀 계산
uintmax_t size = 0;
for (const auto& entry : fs::recursive_directory_iterator("dir")) {
    if (entry.is_regular_file()) {
        size += entry.file_size();
    }
}

문제 3: 심볼릭 링크

fs::path link = "symlink";

// 링크 자체 상태
auto linkStatus = fs::symlink_status(link);

// 링크 대상 상태
auto targetStatus = fs::status(link);

문제 4: 권한 에러

// ❌ 권한 없으면 예외
for (const auto& entry : fs::recursive_directory_iterator("/")) {
    // 권한 에러
}

// ✅ 에러 무시
for (const auto& entry : fs::recursive_directory_iterator("/",
    fs::directory_options::skip_permission_denied)) {
    std::cout << entry.path() << std::endl;
}

파일 비교

fs::path p1 = "file1.txt";
fs::path p2 = "file2.txt";

// 같은 파일?
if (fs::equivalent(p1, p2)) {
    std::cout << "같은 파일" << std::endl;
}

// 수정 시간 비교
if (fs::last_write_time(p1) > fs::last_write_time(p2)) {
    std::cout << "p1이 더 최신" << std::endl;
}

FAQ

Q1: directory_iterator는?

A: C++17. 디렉토리 순회.

Q2: 재귀 순회?

A: recursive_directory_iterator.

Q3: 권한 에러?

A: skip_permission_denied 옵션.

Q4: 파일 크기?

A: file_size() 또는 entry.file_size().

Q5: 수정 시간?

A: last_write_time().

Q6: directory_iterator 학습 리소스는?

A:

• “C++17 The Complete Guide”
• “C++ Primer”
• cppreference.com

---

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

• C++ Filesystem | “파일시스템” C++17 라이브러리 가이드
• C++ Directory Iterator | “디렉토리 순회” 가이드
• C++ Filesystem | “파일시스템 라이브러리” 가이드

관련 글

• C++ Directory Iterator |
• C++ File Operations |
• C++ Filesystem 빠른 참조 |
• C++ Filesystem 개념 정리 |
• C++ path |