std::experimental::filesystem:: path

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

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

Der Pfadname hat die folgende Syntax:

1. root-name (optional) : identifiziert das Root-Verzeichnis in einem Dateisystem mit mehreren Roots (wie "C:" oder "//myserver" ). POSIX-Dateisysteme haben einen einzelnen Root.
2. root-directory (optional) : ein Verzeichnistrennzeichen, das, falls vorhanden, diesen Pfad als absolut kennzeichnet. Wenn es fehlt (und das erste Element außer dem Root-Namen ein Dateiname ist), dann ist der Pfad relativ und benötigt einen anderen Pfad als Ausgangspunkt, um zu einem Dateinamen aufgelöst zu werden.
3. Null oder mehr der folgenden Elemente:

• file-name : Eine Folge von Zeichen, die keine Verzeichnistrennzeichen oder bevorzugte Verzeichnistrennzeichen sind (zusätzliche Einschränkungen können durch das Betriebssystem oder Dateisystem auferlegt werden). Dieser Name kann eine Datei, einen Hard Link, einen symbolischen Link oder ein Verzeichnis identifizieren. Zwei spezielle file-name s werden erkannt:

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

• directory-separator s: Das Schrägstrich-Zeichen / oder das alternative Zeichen, das als path::preferred_separator bereitgestellt wird. Wenn dieses Zeichen wiederholt wird, wird es als ein einzelnes Verzeichnistrennzeichen behandelt: / usr ///////lib ist dasselbe wie / usr / lib .

Der Pfad kann elementweise über Iteratoren durchlaufen werden, die von den begin() und end() Funktionen zurückgegeben werden. Diese iterieren über Root-Namen, Root-Verzeichnis und die nachfolgenden Dateinamenelemente (Verzeichnistrennzeichen werden übersprungen, außer demjenigen, der das Root-Verzeichnis identifiziert). Wenn das letzte Element im Pfad ein Verzeichnistrennzeichen ist, wird der letzte Iterator auf einen Dateinamen dot verweisen.

Der Aufruf einer beliebigen nicht-konstanten Memberfunktion eines path invalidiert alle Iteratoren, die auf Elemente dieses Objekts verweisen.

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

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

Inhaltsverzeichnis 1 Member-Typen 2 Member-Konstanten 3 Member-Funktionen 3.1 Verkettung 3.2 Modifikatoren 3.3 Format-Beobachter 3.4 Vergleich 3.5 Zerlegung 3.6 Abfragen 3.7 Iteratoren 4 Nicht-Member-Funktionen

Mitgliedertypen

Typ	Definition
value_type	Zeichentyp, der von der nativen Kodierung des Dateisystems verwendet wird: char auf POSIX, wchar_t auf 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

Member-Konstanten

constexpr value_type preferred_separator [static]

Alternativer Verzeichnisseparator, der zusätzlich zum portablen / verwendet werden kann. Unter Windows ist dies der Backslash \ . Unter POSIX ist dies derselbe Schrägstrich / wie der portable Separator (öffentliche statische Member-Konstante)

Memberfunktionen

(Konstruktor)	konstruiert einen path (öffentliche Elementfunktion)
(destructor)	zerstört ein path Objekt (öffentliche Elementfunktion)
operator=	weist einen anderen Pfad zu (öffentliche Elementfunktion)
assign	weist Inhalte zu (öffentliche Elementfunktion)
Verkettung
append operator/=	fügt Elemente zum Pfad hinzu (öffentliche Elementfunktion)
concat operator+=	verkettet zwei Pfade ohne Einführung eines Verzeichnistrennzeichens (öffentliche Elementfunktion)
Modifikatoren
clear	löscht den Inhalt (öffentliche Elementfunktion)
make_preferred	wandelt Verzeichnistrennzeichen in das bevorzugte Verzeichnistrennzeichen um (öffentliche Elementfunktion)
remove_filename	entfernt den Dateinamen-Pfadbestandteil (öffentliche Elementfunktion)
replace_filename	ersetzt die letzte Pfadkomponente durch einen anderen Pfad (öffentliche Elementfunktion)
replace_extension	ersetzt die Erweiterung (öffentliche Elementfunktion)
swap	tauscht zwei Pfade aus (öffentliche Elementfunktion)
Format-Beobachter
c_str native operator string_type	gibt die native Version des Pfades zurück (öffentliche Member-Funktion)
string wstring u8string u16string u32string	gibt den Pfad im nativen Pfadnamenformat als String zurück (öffentliche Member-Funktion)
generic_string generic_wstring generic_u8string generic_u16string generic_u32string	gibt den Pfad im generischen Pfadnamenformat als String zurück (öffentliche Elementfunktion)
Vergleichen
compare	vergleicht die lexikalischen Darstellungen zweier Pfade lexikographisch (öffentliche Elementfunktion)
Zerlegung
root_name	gibt den Root-Namen des Pfades zurück, falls vorhanden (öffentliche Elementfunktion)
root_directory	gibt das Wurzelverzeichnis des Pfades zurück, falls vorhanden (öffentliche Elementfunktion)
root_path	gibt den Root-Pfad des Pfades zurück, falls vorhanden (öffentliche Member-Funktion)
relative_path	gibt Pfad relativ zum Wurzelpfad zurück (öffentliche Elementfunktion)
parent_path	gibt den Pfad des übergeordneten Pfads zurück (öffentliche Elementfunktion)
filename	gibt die Dateinamen-Pfadkomponente zurück (öffentliche Elementfunktion)
stem	gibt die Stammkomponente des Pfades zurück (öffentliche Elementfunktion)
extension	gibt die Dateierweiterungskomponente des Pfades zurück (öffentliche Memberfunktion)
Abfragen
empty	prüft, ob der Pfad leer ist (öffentliche Elementfunktion)
has_root_path has_root_name has_root_directory has_relative_path has_parent_path has_filename has_stem has_extension	prüft, ob das entsprechende Pfadelement nicht leer ist (öffentliche Elementfunktion)
is_absolute is_relative	prüft, ob root_path() einen Dateisystemstandort eindeutig identifiziert (öffentliche Elementfunktion)
Iteratoren
begin end	Iterator-Zugriff auf den Pfad als Elementesequenz (öffentliche Elementfunktion)

Nicht-Member-Funktionen

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