std::experimental::filesystem::directory_entry::status, std::experimental::filesystem::directory_entry::symlink_status

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dateisystem-Bibliothek

Klassen
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator filesystem::file_status	filesystem::space_info filesystem::file_type filesystem::perms filesystem::copy_options filesystem::directory_options filesystem::file_time_type
Funktionen
filesystem::absolute filesystem::system_complete filesystem::canonical filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path filesystem::exists filesystem::equivalent	filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status filesystem::temp_directory_path
Dateitypen
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

directory_entry

Template:cpp/experimental/fs/directory entry/navbar content

 

file_status status() const; file_status status( error_code& ec ) const;	(1)	(Dateisystem-TS)
file_status symlink_status() const; file_status symlink_status( error_code& ec ) const;	(2)	(Dateisystem-TS)

1) Gibt den potenziell zwischengespeicherten Status des Eintrags zurück, als ob er durch einen status-Aufruf ermittelt worden wäre (symbolische Links werden zu ihren Zielen verfolgt).

2) Gibt den potenziell zwischengespeicherten Status des Eintrags zurück, als ob er durch einen symlink_status-Aufruf ermittelt worden wäre (symbolische Links werden nicht verfolgt).

Parameter

ec

-

Ausgabeparameter für die Fehlerberichterstattung in der nicht auslösenden Überladung

Rückgabewert

Der Status der Datei, auf die sich der Eintrag bezieht.

Ausnahmen

Die Überladung, die keinen Parameter vom Typ error_code& enthält, löst filesystem_error bei Fehlern der zugrunde liegenden OS-API aus, konstruiert mit p als erstem Argument und dem OS-Fehlercode als Fehlercode-Argument. std::bad_alloc kann ausgelöst werden, wenn die Speicherzuweisung fehlschlägt. Die Überladung, die einen Parameter vom Typ error_code& enthält, setzt diesen auf den OS-API-Fehlercode, wenn ein OS-API-Aufruf fehlschlägt, und führt ec.clear() aus, wenn keine Fehler auftreten. Diese Überladung hat

noexcept-Spezifikation:  

noexcept

  

Hinweise

Die Datei-Statusinformationen werden normalerweise als Nebenprodukt der Verzeichnisiteration bereitgestellt, in welchem Fall sie zwischengespeichert werden und durch diese Memberfunktionen ohne zusätzliche Systemaufrufe abgerufen werden können. Während der Verzeichnisiteration ist das Aufrufen von status unnötig und Zugriffsfunktionen wie is_directory sollten mit dem zwischengespeicherten Statuswert aufgerufen werden, nicht mit einem Pfad.

Beispiel

Führen Sie diesen Code aus

#include <cstdio>
#include <cstring>
#include <experimental/filesystem>
#include <fstream>
#include <iostream>
#include <sys/socket.h>
#include <sys/stat.h>
#include <sys/un.h>
#include <unistd.h>
 
namespace fs = std::experimental::filesystem;
 
void demo_status(const fs::path& p, fs::file_status s)
{
    std::cout << p;
    // alternative: switch(s.type()) { case fs::file_type::regular: ... }
    if (fs::is_regular_file(s))
        std::cout << " is a regular file\n";
    if (fs::is_directory(s))
        std::cout << " is a directory\n";
    if (fs::is_block_file(s))
        std::cout << " is a block device\n";
    if (fs::is_character_file(s))
        std::cout << " is a character device\n";
    if (fs::is_fifo(s))
        std::cout << " is a named IPC pipe\n";
    if (fs::is_socket(s))
        std::cout << " is a named IPC socket\n";
    if (fs::is_symlink(s))
        std::cout << " is a symlink\n";
    if (!fs::exists(s))
        std::cout << " does not exist\n";
}
 
int main()
{
    // create files of different kinds
    fs::create_directory("sandbox");
    std::ofstream("sandbox/file"); // create regular file
    fs::create_directory("sandbox/dir");
    mkfifo("sandbox/pipe", 0644);
    struct sockaddr_un addr;
    addr.sun_family = AF_UNIX;
    std::strcpy(addr.sun_path, "sandbox/sock");
    int fd = socket(PF_UNIX, SOCK_STREAM, 0);
    bind(fd, (struct sockaddr*)&addr, sizeof addr);
    fs::create_symlink("file", "sandbox/symlink");
 
    // demo different status accessors
    for (auto it = fs::directory_iterator("sandbox"); it != fs::directory_iterator(); ++it)
        demo_status(*it, it->symlink_status()); // use cached status from directory entry
    demo_status("dev/null", fs::status("/dev/null")); // direct calls to status
    demo_status("dev/sda", fs::status("/dev/sda"));
    demo_status("sandbox/no", fs::status("/sandbox/no"));
 
    // cleanup
    close(fd);
    fs::remove_all("sandbox");
}

Mögliche Ausgabe

"sandbox/file" is a regular file
"sandbox/dir" is a directory
"sandbox/pipe" is a named IPC pipe
"sandbox/sock" is a named IPC socket
"sandbox/symlink" is a symlink
"dev/null" is a character device
"dev/sda" is a block device
"sandbox/no" does not exist

Siehe auch

file_status	repräsentiert Dateityp und Berechtigungen (Klasse)
statussymlink_status	ermittelt Dateiattribute ermittelt Dateiattribute, wobei das Ziel des symbolischen Links geprüft wird (Funktion)
status_known	prüft, ob der Dateistatus bekannt ist (Funktion)
is_block_file	prüft, ob der gegebene Pfad auf ein Blockgerät verweist (Funktion)
is_character_file	prüft, ob der gegebene Pfad auf ein Zeichengerät verweist (Funktion)
is_directory	prüft, ob der gegebene Pfad auf ein Verzeichnis verweist (Funktion)
is_fifo	prüft, ob der gegebene Pfad auf eine benannte Pipe verweist (Funktion)
is_other	prüft, ob das Argument auf eine andere Datei verweist (Funktion)
is_regular_file	prüft, ob das Argument auf eine reguläre Datei verweist (Funktion)
is_socket	prüft, ob das Argument auf einen benannten IPC-Socket verweist (Funktion)
is_symlink	prüft, ob das Argument auf einen symbolischen Link verweist (Funktion)