Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::filesystem::status: tipo e permissões de um objeto

std::filesystem::status lê o file_status do objeto nomeado por um caminho e segue links simbólicos durante a resolução.

Versão: C++23

Sintaxe

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) de <filesystem> devolve um file_status com file_type e bits perms. A resolução segue links; usa symlink_status para inspecionar o próprio link. Predicados como is_regular_file e is_directory aceitam o estado devolvido.

O exemplo cria um ficheiro normal, obtém o estado pela sobrecarga error_code e imprime 1 0: o tipo é regular e ec está vazio. O estado é apenas uma observação no instante da chamada; outro processo pode alterar ou remover o ficheiro logo depois.

not_found significa ausência conhecida, unknown um objeto resolvido cujos atributos não se determinaram e none um erro que impediu até essa distinção. not_found e unknown não fazem a sobrecarga que lança produzir exceção; a forma error_code& é noexcept e ec deve ser verificado separadamente do tipo.

Exemplos

#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);
}

Resultado

1 0

std::filesystem::status → 1 0

Fontes