std::experimental::filesystem::path

 

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

 

path

Memberfunktionen
path::path path::~path path::operator= path::assign path::appendoperator /= path::concatoperator += path::clear path::make_preferred path::remove_filename path::replace_filename path::replace_extension path::swap path::compare	path::c_strpath::nativeoperator string_type path::stringpath::u8stringpath::u16stringpath::u32stringpath::wstring path::generic_stringpath::generic_u8stringpath::generic_u16stringpath::generic_u32stringpath::generic_wstring path::beginpath::end
Pfadtrennung
path::root_name path::root_directory path::root_path path::relative_path path::parent_path path::filename path::stem path::extension path::empty	path::has_root_pathpath::has_root_namepath::has_root_directorypath::has_relative_pathpath::has_parent_pathpath::has_filenamepath::has_stempath::has_extension path::is_absolutepath::is_relative
Nicht-Member-Funktionen
swap(path)
operator==operator!=operator<operator<=operator>operator>=
operator/
operator<<operator>>
u8path

 

Definiert im Header <experimental/filesystem>
class path;		(Dateisystem-TS)

Objekte vom Typ path repräsentieren Pfade in einem Dateisystem. Es werden nur syntaktische Aspekte von Pfaden behandelt: Der Pfadname kann einen nicht existierenden Pfad darstellen oder sogar einen, der auf dem aktuellen Dateisystem oder Betriebssystem nicht existieren darf.

Der Pfadname hat folgende Syntax

1. root-name(optional): identifiziert das Stammverzeichnis in einem Dateisystem mit mehreren Stammverzeichnissen (wie z.B. "C:" oder "//myserver". POSIX-Dateisysteme haben ein einzelnes Stammverzeichnis.
2. root-directory(optional): ein Verzeichnistrenner, der, wenn vorhanden, diesen Pfad als absolut markiert. Wenn er fehlt (und das erste Element außer dem Stammverzeichnis ein Dateiname ist), dann ist der Pfad relativ und erfordert einen anderen Pfad als Startposition, um zu einem Dateinamen aufgelöst zu werden.
3. Null oder mehr der folgenden

• file-name: eine Zeichensequenz, die keine Verzeichnistrenner oder bevorzugten Verzeichnistrenner sind (zusätzliche Einschränkungen können vom Betriebssystem oder Dateisystem auferlegt werden). Dieser Name kann eine Datei, einen Hardlink, einen symbolischen Link oder ein Verzeichnis identifizieren. Zwei spezielle file-names werden erkannt

• dot: der Dateiname, der aus einem einzelnen Punktzeichen . besteht, ist ein Verzeichnisname, der auf das aktuelle Verzeichnis verweist.
• dot-dot: der Dateiname, der aus zwei Punktzeichen .. besteht, ist ein Verzeichnisname, der auf das übergeordnete Verzeichnis verweist.

• directory-separators: das Schrägstrichzeichen / oder das als path::preferred_separator bereitgestellte alternative Zeichen. Wenn dieses Zeichen wiederholt wird, wird es als einzelner Verzeichnistrenner behandelt: /usr///////lib ist dasselbe wie /usr/lib.

Der Pfad kann elementweise über Iteratoren durchlaufen werden, die von den Funktionen begin() und end() zurückgegeben werden. Diese iterieren über Stammverzeichnisnamen, Stammverzeichnisse und die nachfolgenden Dateinamenelemente (Verzeichnistrenner werden übersprungen, mit Ausnahme desjenigen, das das Stammverzeichnis identifiziert). Wenn das letzte Element im Pfad ein Verzeichnistrenner ist, dereferenziert der letzte Iterator zu einem Dateinamen dot.

Der Aufruf einer beliebigen nicht-const-Memberfunktion eines path macht alle Iteratoren, die sich auf Elemente dieses Objekts beziehen, ungültig.

Wenn das Betriebssystem eine native Syntax verwendet, die sich von der oben beschriebenen portablen generischen Syntax unterscheidet, akzeptieren alle Bibliotheksfunktionen Pfadnamen in beiden Formaten.

Pfade sind implizit zu und von std::basic_strings konvertierbar, was es ermöglicht, sie mit anderen Dateisystem-APIs zu verwenden, z.B. als Argument für std::ifstream::open.

Membertypen

Typ	Definition
value_type	Zeichentyp, der von der nativen Codierung des Dateisystems verwendet wird: char unter POSIX, wchar_t unter Windows
string_type	std::basic_string<value_type>
const_iterator	Ein konstanter LegacyBidirectionalIterator mit einem value_type von path
iterator	Ein Alias für const_iterator

Memberkonstanten

constexpr value_type preferred_separator [static]

alternativer Verzeichnistrenner, der zusätzlich zum portablen / verwendet werden kann. Unter Windows ist dies das umgekehrte Schrägstrichzeichen \. Unter POSIX ist dies derselbe Schrägstrich / wie der portable Trenner (öffentliche statische Member-Konstante)

Memberfunktionen

(Konstruktor)	konstruiert einen path (public member function)
(Destruktor)	zerstört ein path-Objekt (public member function)
operator=	weist einen anderen Pfad zu (public member function)
assign	weist Inhalte zu (public member function)
Verkettung
appendoperator/=	hängt Elemente an den Pfad an (public member function)
concatoperator+=	verkettet zwei Pfade ohne Einführung eines Verzeichnistrenners (public member function)
Modifizierer
clear	löscht den Inhalt (public member function)
make_preferred	konvertiert Verzeichnistrenner in den bevorzugten Verzeichnistrenner (public member function)
remove_filename	entfernt die Dateinamen-Pfadkomponente (public member function)
replace_filename	ersetzt die letzte Pfadkomponente durch einen anderen Pfad (public member function)
replace_extension	ersetzt die Dateiendung (public member function)
swap	tauscht zwei Pfade (public member function)
Format-Beobachter
c_strnativeoperator string_type	gibt die native Version des Pfades zurück (public member function)
stringwstringu8stringu16stringu32string	gibt den Pfad im nativen Pfadnamen-Format als String zurück (public member function)
generic_stringgeneric_wstringgeneric_u8stringgeneric_u16stringgeneric_u32string	gibt den Pfad im generischen Pfadnamen-Format als String zurück (public member function)
Compare
compare	vergleicht die lexikalischen Darstellungen zweier Pfade lexikographisch (public member function)
Zerlegung
root_name	gibt den Root-Namen des Pfades zurück, falls vorhanden (public member function)
root_directory	gibt das Root-Verzeichnis des Pfades zurück, falls vorhanden (public member function)
root_path	gibt den Root-Pfad des Pfades zurück, falls vorhanden (public member function)
relative_path	gibt den Pfad relativ zum Stammverzeichnis zurück (public member function)
parent_path	gibt den Pfad des übergeordneten Verzeichnisses zurück (public member function)
filename	gibt die Dateinamen-Pfadkomponente zurück (public member function)
stem	gibt die Stammkomponente des Pfads zurück (public member function)
extension	gibt die Dateiendungs-Pfadkomponente zurück (public member function)
Abfragen
empty	prüft, ob der Pfad leer ist (public member function)
has_root_pathhas_root_namehas_root_directoryhas_relative_pathhas_parent_pathhas_filenamehas_stemhas_extension	prüft, ob das entsprechende Pfadelement nicht leer ist (public member function)
is_absoluteis_relative	prüft, ob root_path() den Dateisystemspeicherort eindeutig identifiziert (public member function)
Iteratoren
beginend	Iteratorzugriff auf den Pfad als Sequenz von Elementen (public member function)

Nicht-Member-Funktionen

swap(std::experimental::filesystem::path)	tauscht zwei Pfade (function)
operator==operator!=operator<operator<=operator>operator>=	vergleicht zwei Pfade lexikographisch (function)
operator/	verkettet zwei Pfade mit einem Verzeichnistrenner (function)
operator<<operator>>	führt Stream-Ein- und Ausgabe für einen Pfad durch (function)
u8path	erstellt einen path aus einer UTF-8-kodierten Quelle (function)