Filesystem library

In ISO C++ integriert Die auf dieser Seite beschriebene Funktionalität wurde ab 3/2016 in den Hauptstandard von ISO C++ integriert; siehe die Filesystem-Bibliothek (seit C++17)

Die Filesystem-Bibliothek, ISO/IEC TS 18822:2015, bietet Einrichtungen zum Ausführen von Operationen auf Dateisystemen und deren Komponenten, wie Pfade, reguläre Dateien und Verzeichnisse.

Diese Bibliothek ist eine optionale technische Spezifikation und möglicherweise nicht verfügbar, wenn ein hierarchisches Dateisystem für die Implementierung nicht zugänglich ist oder wenn es die notwendigen Fähigkeiten nicht bereitstellt. Einige Funktionen sind möglicherweise nicht verfügbar, wenn sie vom zugrundeliegenden Dateisystem nicht unterstützt werden (z.B. bietet das FAT-Dateisystem keine Hardlinks, Softlinks und andere Funktionen).

Das Verhalten ist undefined , wenn Aufrufe von Funktionen in dieser Bibliothek einen file system race verursachen, das heißt, wenn mehrere Threads, Prozesse oder Computer den Zugriff und die Modifikation desselben Objekts in einem Dateisystem überlappen.

Diese Bibliothek basiert direkt auf boost.filesystem , das derzeit auf mehr Compilern und Plattformen verfügbar ist als diese experimentelle technische Spezifikation.

Inhaltsverzeichnis 1 Bibliotheksweite Definitionen 2 Klassen 3 Nicht-Member-Funktionen 3.1 Dateitypen 4 Siehe auch

Bibliotheksweite Definitionen

• file : ein Dateisystemobjekt, das Daten enthält und in das geschrieben oder aus dem gelesen werden kann oder beides. Dateien haben Namen, Attribute, von denen eines der Dateityp ist:

• directory : eine Datei, die als Container für Verzeichniseinträge fungiert, die andere Dateien identifizieren (einige davon können andere, verschachtelte Verzeichnisse sein). Bei der Diskussion einer bestimmten Datei ist das Verzeichnis, in dem sie als Eintrag erscheint, ihr parent directory . Das übergeordnete Verzeichnis kann durch den relativen Pfadnamen ".." dargestellt werden.
• hard link : ein Verzeichniseintrag, der einen Namen mit einer bestehenden Datei verknüpft. Wenn mehrere Hard Links unterstützt werden, wird die Datei entfernt, nachdem der letzte Hard Link zu ihr entfernt wurde.
• symbolic link : ein Verzeichniseintrag, der einen Namen mit einem Pfad verknüpft, der existieren kann oder nicht.
• regular file : eine Datei, die keinem der anderen Dateitypen entspricht.

• Dateiname : eine Zeichenkette, die eine Datei benennt. Zulässige Zeichen, Groß-/Kleinschreibung, maximale Länge und unzulässige Namen sind implementierungsdefiniert. Die Namen . (Punkt) und .. (Punkt-Punkt) haben auf Bibliotheksebene besondere Bedeutung.
• Pfad : eine Folge von Elementen, die eine Datei identifiziert. Er beginnt mit einem optionalen root-name (z.B. "C:" oder "//server" ), gefolgt von einem optionalen root-directory (z.B. "/" unter Unix), gefolgt von einer Folge von null oder mehr Dateinamen (von denen alle außer dem letzten Verzeichnisse oder Links zu Verzeichnissen sein müssen). Das native Format (z.B. welche Zeichen als Trennzeichen verwendet werden) und die Zeichenkodierung der Zeichenkettenrepräsentation eines Pfads (der Pfadname ) ist implementierungsdefiniert; diese Bibliothek bietet eine portable Darstellung von Pfaden.

• absolute path : ein Pfad, der den Speicherort einer Datei eindeutig identifiziert.
• canonical path : ein absoluter Pfad, der keine Symlinks, "." oder ".." Elemente enthält.
• relative path : ein Pfad, der eine Datei relativ zu einem bestimmten Ort im Dateisystem identifiziert. Die speziellen Pfadnamen . (Punkt, "aktuelles Verzeichnis") und .. (Punkt-Punkt, "übergeordnetes Verzeichnis") sind relative Pfade.

Klassen

path	repräsentiert einen Pfad (Klasse)
filesystem_error	eine Ausnahme bei Dateisystemfehlern (Klasse)
directory_entry	ein Verzeichniseintrag (Klasse)
directory_iterator	ein Iterator für die Inhalte eines Verzeichnisses (Klasse)
recursive_directory_iterator	ein Iterator für die Inhalte eines Verzeichnisses und seiner Unterverzeichnisse (Klasse)
file_status	repräsentiert Dateityp und Berechtigungen (Klasse)
space_info	Informationen über freien und verfügbaren Speicherplatz im Dateisystem (Klasse)
file_type	der Typ einer Datei (Enumeration)
perms	identifiziert Dateisystemberechtigungen (Enumeration)
copy_options	spezifiziert die Semantik von Kopiervorgängen (Enumeration)
directory_options	Optionen für die Iteration von Verzeichnisinhalten (Enumeration)
file_time_type	repräsentiert Dateizeitwerte (Typdefinition)

Nicht-Member-Funktionen

absolute system_complete	bildet einen absoluten Pfad konvertiert einen Pfad zu einem absoluten Pfad unter Nachbildung OS-spezifischen Verhaltens (Funktion)
canonical	bildet einen kanonischen Pfad (Funktion)
copy	kopiert Dateien oder Verzeichnisse (Funktion)
copy_file	kopiert Dateiinhalte (Funktion)
copy_symlink	kopiert einen symbolischen Link (Funktion)
create_directory create_directories	erstellt neues Verzeichnis (Funktion)
create_hard_link	erstellt eine Hardlink (Funktion)
create_symlink create_directory_symlink	erstellt eine symbolische Verknüpfung (Funktion)
current_path	gibt das aktuelle Arbeitsverzeichnis zurück (Funktion)
exists	prüft, ob der Pfad auf ein existierendes Dateisystemobjekt verweist (Funktion)
equivalent	prüft, ob zwei Pfade auf dasselbe Dateisystemobjekt verweisen (Funktion)
file_size	gibt die Größe einer Datei zurück (Funktion)
hard_link_count	gibt die Anzahl der Hardlinks zurück, die auf die spezifische Datei verweisen (Funktion)
last_write_time	ermittelt oder setzt den Zeitpunkt der letzten Datenänderung (Funktion)
permissions	ändert Dateizugriffsberechtigungen (Funktion)
read_symlink	ermittelt das Ziel eines symbolischen Links (Funktion)
remove remove_all	entfernt eine Datei oder leeres Verzeichnis entfernt eine Datei oder Verzeichnis und alle dessen Inhalte rekursiv (Funktion)
rename	verschiebt oder benennt eine Datei oder ein Verzeichnis um (Funktion)
resize_file	ändert die Größe einer regulären Datei durch Kürzung oder Auffüllung mit Nullen (Funktion)
space	ermittelt den verfügbaren freien Speicherplatz im Dateisystem (Funktion)
status symlink_status	bestimmt Dateiattribute bestimmt Dateiattribute, überprüft das Symlink-Ziel (Funktion)
temp_directory_path	gibt ein Verzeichnis zurück, das für temporäre Dateien geeignet ist (Funktion)
Dateitypen
is_block_file	prüft, ob der angegebene Pfad auf ein Blockgerät verweist (Funktion)
is_character_file	prüft, ob der angegebene Pfad auf ein Zeichengerät verweist (Funktion)
is_directory	prüft, ob der angegebene Pfad auf ein Verzeichnis verweist (Funktion)
is_empty	prüft, ob der angegebene Pfad auf eine leere Datei oder ein leeres Verzeichnis verweist (Funktion)
is_fifo	prüft, ob der angegebene Pfad auf eine Named 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)
status_known	prüft, ob der Dateistatus bekannt ist (Funktion)

Siehe auch

C++ Dokumentation für Filesystem library (C++17)