Dateisystem-Bibliothek

 

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

 

Experimentell

Technische Spezifikation

Dateisystembibliothek (filesystem TS)

Grundlagen der Bibliothek (Library Fundamentals TS)

Grundlagen der Bibliothek 2 (Library Fundamentals TS v2)

Grundlagen der Bibliothek 3 (Library Fundamentals TS v3)

Erweiterungen für Parallelität (Parallelism TS)

Erweiterungen für Parallelität 2 (Parallelism TS v2)

Erweiterungen für Nebenläufigkeit (Concurrency TS)

Erweiterungen für Nebenläufigkeit 2 (Concurrency TS v2)

Konzepte (Concepts TS)

Bereiche (Ranges TS)

Reflektion (Reflection TS)

Mathematische Spezialfunktionen (Special Functions TR)

Experimentell Nicht-TS

Pattern Matching

Lineare Algebra

std::execution

Verträge

2D-Grafik

 

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

 

Die Dateisystembibliothek, ISO/IEC TS 18822:2015, stellt Einrichtungen für Operationen auf Dateisystemen und deren Komponenten bereit, wie z.B. Pfade, reguläre Dateien und Verzeichnisse.

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

Das Verhalten ist undefiniert, wenn Aufrufe von Funktionen in dieser Bibliothek ein Dateisystemrennen (file system race) verursachen, d.h., wenn mehrere Threads, Prozesse oder Computer den Zugriff und die Änderung desselben Objekts in einem Dateisystem miteinander verweben.

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

Bibliotheksweite Definitionen

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

• Verzeichnis: Eine Datei, die als Container für Verzeichniseinträge dient, die andere Dateien (von denen einige andere, verschachtelte Verzeichnisse sein können) identifizieren. Wenn über eine bestimmte Datei gesprochen wird, ist das Verzeichnis, in dem sie als Eintrag erscheint, ihr übergeordnetes Verzeichnis. Das übergeordnete Verzeichnis kann durch den relativen Pfadnamen ".." repräsentiert werden.
• Hardlink: Ein Verzeichniseintrag, der einen Namen mit einer vorhandenen Datei verknüpft. Wenn mehrere Hardlinks unterstützt werden, wird die Datei nach der Entfernung des letzten Hardlinks zu ihr gelöscht.
• Symbolischer Link: Ein Verzeichniseintrag, der einen Namen mit einem Pfad verknüpft, der existieren kann oder auch nicht.
• Reguläre Datei: Eine Datei, die keiner der anderen Dateitypen ist.

• Dateiname: Eine Zeichenkette, die einer Datei einen Namen gibt. Zulässige Zeichen, Groß-/Kleinschreibung, maximale Länge und die nicht zulässigen Namen sind implementierungsabhängig. Die Namen . (Punkt) und .. (Punkt-Punkt) haben auf Bibliotheksebene eine besondere Bedeutung.
• Pfad: Eine Sequenz von Elementen, die eine Datei identifiziert. Er beginnt mit einem optionalen Root-Namen (z.B. "C:" oder "//server"), gefolgt von einem optionalen Root-Verzeichnis (z.B. "/" unter Unix), gefolgt von einer Sequenz von null oder mehr Dateinamen (alle außer dem letzten müssen Verzeichnisse oder Links zu Verzeichnissen sein). Das native Format (z.B. welche Zeichen als Trennzeichen verwendet werden) und die Zeichenkodierung der String-Repräsentation eines Pfades (des Pfadnamens) sind implementierungsabhängig; diese Bibliothek bietet eine portable Darstellung von Pfaden.

• Absoluter Pfad: Ein Pfad, der den Speicherort einer Datei eindeutig identifiziert.
• Kanonischer Pfad: Ein absoluter Pfad, der keine Symlinks, "." oder ".." Elemente enthält.
• Relativer Pfad: Ein Pfad, der eine Datei relativ zu einem bestimmten Speicherort 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, die bei Dateisystemfehlern ausgelöst wird (Klasse)
directory_entry	ein Verzeichniseintrag (Klasse)
directory_iterator	ein Iterator für den Inhalt des Verzeichnisses (Klasse)
recursive_directory_iterator	ein Iterator für den Inhalt eines Verzeichnisses und seiner Unterverzeichnisse (Klasse)
file_status	repräsentiert Dateityp und Berechtigungen (Klasse)
space_info	Informationen über freien und verfügbaren Speicherplatz auf dem Dateisystem (Klasse)
file_type	der Typ einer Datei (Aufzählung)
perms	identifiziert Dateisystemberechtigungen (Aufzählung)
copy_options	spezifiziert die Semantik von Kopiervorgängen (Aufzählung)
directory_options	Optionen für das Iterieren über Verzeichnisinhalte (Aufzählung)
file_time_type	repräsentiert Datei-Zeitwerte (Typedef)

Nicht-Member-Funktionen

absolutesystem_complete	komponiert einen absoluten Pfad konvertiert einen Pfad in einen absoluten Pfad, der das OS-spezifische Verhalten repliziert (Funktion)
canonical	komponiert einen kanonischen Pfad (Funktion)
copy	kopiert Dateien oder Verzeichnisse (Funktion)
copy_file	kopiert Dateiinhalte (Funktion)
copy_symlink	kopiert einen symbolischen Link (Funktion)
create_directorycreate_directories	erstellt neues Verzeichnis (Funktion)
create_hard_link	erstellt einen Hardlink (Funktion)
create_symlinkcreate_directory_symlink	erstellt einen symbolischen Link (Funktion)
current_path	gibt das aktuelle Arbeitsverzeichnis zurück (Funktion)
exists	prüft, ob ein 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	liest oder setzt die Zeit der letzten Datenmodifikation (Funktion)
permissions	modifiziert Dateizugriffsberechtigungen (Funktion)
read_symlink	ermittelt das Ziel eines symbolischen Links (Funktion)
removeremove_all	entfernt eine Datei oder ein leeres Verzeichnis entfernt eine Datei oder ein Verzeichnis und dessen gesamten Inhalt rekursiv (Funktion)
rename	verschiebt oder benennt eine Datei oder ein Verzeichnis um (Funktion)
resize_file	ändert die Größe einer regulären Datei durch Abschneiden oder Auffüllen mit Nullen (Funktion)
Leerzeichen	ermittelt den verfügbaren freien Speicherplatz auf dem Dateisystem (Funktion)
statussymlink_status	ermittelt Dateiattribute ermittelt Dateiattribute, wobei das Ziel des symbolischen Links geprüft wird (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 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_empty	prüft, ob der gegebene Pfad auf eine leere Datei oder ein leeres 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)
status_known	prüft, ob der Dateistatus bekannt ist (Funktion)

Siehe auch

C++ Dokumentation für Dateisystembibliothek (C++17)