WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::filesystem::status: Objekttyp und Rechte

std::filesystem::status liest den file_status des durch einen Pfad bezeichneten Objekts und folgt Symlinks bei der Auflösung.

Version: C++23

Syntax

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) aus <filesystem> liefert einen file_status mit file_type und perms-Bits. Die Pfadauflösung folgt Symlinks; für den Link selbst dient symlink_status. Prädikate wie is_regular_file und is_directory akzeptieren den Status.

Das Beispiel erstellt eine reguläre Datei, liest den Status per error_code-Overload und gibt 1 0 aus: Der Typ ist regulär und ec leer. Ein Status ist nur eine Momentaufnahme; ein anderer Prozess kann die Datei unmittelbar danach ändern oder entfernen.

not_found bedeutet bekannte Abwesenheit, unknown ein aufgelöstes Objekt mit unbestimmbaren Attributen und none einen Fehler, der selbst diese Unterscheidung verhindert. not_found und unknown erzwingen beim werfenden Overload keine Ausnahme; die error_code&-Form ist noexcept, und ec ist unabhängig vom Typ zu prüfen.

Beispiele

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

Ergebnis

1 0

std::filesystem::status → 1 0

Quellen