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