Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::filesystem::status: typ i uprawnienia obiektu

std::filesystem::status odczytuje file_status obiektu wskazanego przez ścieżkę, śledząc napotkane dowiązania symboliczne.

Wersja: C++23

Składnia

std::filesystem::file_status std::filesystem::status(
    const std::filesystem::path& p);

std::filesystem::file_status std::filesystem::status(
    const std::filesystem::path& p, std::error_code& ec) noexcept;

std::filesystem::status(p) z <filesystem> zwraca file_status zawierający file_type i bity perms. Rozwiązanie ścieżki śledzi dowiązania; aby zbadać samo dowiązanie, użyj symlink_status. Predykaty takie jak is_regular_file i is_directory przyjmują zwrócony status.

Przykład tworzy zwykły plik, pobiera status wariantem z error_code i drukuje 1 0: typ jest regularny, a ec jest pusty. Status jest obserwacją z chwili wywołania; inny proces może natychmiast zmienić lub usunąć plik.

not_found oznacza znany brak, unknown — rozwiązany obiekt o nieustalonych atrybutach, a none — błąd uniemożliwiający nawet takie rozstrzygnięcie. not_found i unknown nie zmuszają wariantu rzucającego do wyjątku; wariant error_code& jest noexcept, a ec trzeba sprawdzać niezależnie od zwróconego typu.

Przykłady

#include <filesystem>
#include <fstream>
#include <iostream>

int main() {
    namespace fs = std::filesystem;
    const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-status";
    const fs::path file = root / "item.txt";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directory(root);
    std::ofstream(file) << "data";

    std::error_code ec;
    const fs::file_status info = fs::status(file, ec);
    std::cout << fs::is_regular_file(info) << ' ' << static_cast<bool>(ec) << '\n';

    fs::remove_all(root, ignored);
}

Wynik

1 0

std::filesystem::status → 1 0

Źródła