Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::filesystem::status : type et permissions d’un objet

std::filesystem::status lit le file_status de l’objet désigné par un chemin et suit les liens symboliques pendant la résolution.

Version : C++23

Syntaxe

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> renvoie un file_status contenant un file_type et des bits perms. La résolution suit les liens ; utilisez symlink_status pour examiner le lien lui-même. is_regular_file, is_directory et les autres prédicats acceptent ce statut.

L’exemple crée un fichier ordinaire, obtient son statut avec la surcharge error_code et affiche 1 0 : le type est régulier et ec est vide. Le statut n’est qu’une observation instantanée ; un autre processus peut aussitôt modifier ou supprimer le fichier.

not_found signifie absence connue, unknown un objet résolu dont les attributs restent indéterminés, et none une erreur empêchant même cette distinction. not_found et unknown ne font pas lancer la surcharge lançante ; la forme error_code& est noexcept et ec doit être contrôlé indépendamment du type.

Exemples

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

Résultat

1 0

std::filesystem::status → 1 0

Sources