CKTIS / C++
Pfade mit `/` in `std::filesystem` verbinden
Der Pfadoperator `/` liefert einen neuen Pfad, ohne die Operanden zu ändern. Die Syntax rechts bestimmt, ob angehängt oder der linke Pfad ganz oder teilweise ersetzt wird.
Version: ISO C++23; implementation support may vary
Syntax
#include <filesystem>
// Friend declaration inside std::filesystem::path (not a member):
friend path operator/(const path& lhs, const path& rhs);
// Typical use, with base of type std::filesystem::path:
base / "guide.txt"In <filesystem> bezeichnet std::filesystem::operator/ einen Operator zum Verbinden von Pfaden, keine Division und keine Memberfunktion. Seit C++17 gibt es ihn als freie Friend-Funktion in std::filesystem. Sie wird durch argumentabhängige Namenssuche (ADL) gefunden, nicht durch qualifizierte Namenssuche. Bei base / "guide.txt" muss base vom Typ path sein; das Literal wird in path umgewandelt. Zwei Stringliterale allein funktionieren mit / nicht.
lhs / rhs wendet /= auf eine Kopie von lhs an und gibt einen path als Wert zurück. Der Memberoperator /= ändert den linken Operanden und liefert eine Referenz darauf. += hingegen hängt den nativen Pfadtext ohne zusätzlichen Trenner an. Ist rhs absolut oder hat es einen anderen Wurzelnamen als lhs, ersetzt es den gesamten linken Pfad. Andernfalls entfernt ein Wurzelverzeichnis in rhs das linke Wurzelverzeichnis und den relativen Teil, nicht aber den Wurzelnamen. Danach wird der rechte Pfad ohne seinen Wurzelnamen angehängt, mit dem bevorzugten Trenner, wo es die Regeln verlangen. Selbst ein leerer rechter Operand kann einen abschließenden Trenner hinzufügen.
Das Verbinden normalisiert den Pfad nicht. p.lexically_normal() liefert einen neuen Pfad, entfernt überflüssige .-Komponenten und vereinfacht Paare wie drafts/... p.lexically_relative(base) berechnet den Weg von base nach p, ohne die Pfade vorher zu normalisieren. Bereits bei den Vorprüfungen gibt die Funktion einen leeren Pfad zurück, wenn etwa die Wurzelnamen verschieden sind oder ein Dateiname im relativen Teil eines der Pfade als Wurzelname interpretiert werden kann. Nur wenn die Pfade diese Prüfungen bestehen, ergibt eine identische Komponentenfolge ..
p.is_absolute() prüft nach den Regeln der Plattform, ob der Pfad absolut ist: / allein ist unter POSIX absolut, unter Windows nicht. p.empty() prüft, ob der Pfadname im generischen Format leer ist, nicht ob ein Verzeichnis leer ist. p.begin() zeigt auf die erste Pfadkomponente, nicht auf ein Zeichen oder einen Verzeichniseintrag. Bei einem leeren Pfad liefert es p.end(). Verwende Iteratoren weder nach der Zerstörung von p noch nach einem Aufruf einer Nicht-const-Memberfunktion auf p. p.generic_string() liefert einen std::string mit / als Trenner, ohne UTF-8 zu garantieren.
Diese Operationen arbeiten mit der Pfadsyntax: Sie prüfen nicht, ob Dateien existieren, und lösen keine symbolischen Links auf. Das Verbinden kann eine Ausnahme wie std::bad_alloc auslösen. Weder / noch lexically_normal() garantiert, dass ein nicht vertrauenswürdiger Pfad innerhalb eines gewählten Verzeichnisses bleibt: Wurzeln, .. oder symbolische Links können diese Annahme widerlegen.
Beispiele
#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;
int main() {
const fs::path base{"docs"};
const fs::path joined = base / "./drafts/../guide.txt";
const fs::path normal = joined.lexically_normal();
const fs::path relative = normal.lexically_relative(base);
std::cout << "base: " << base.generic_string() << '\n'
<< "joined: " << joined.generic_string() << '\n'
<< "normal: " << normal.generic_string() << '\n'
<< "relative: " << relative.generic_string() << '\n'
<< "first: " << normal.begin()->generic_string() << '\n'
<< std::boolalpha
<< "absolute: " << normal.is_absolute() << '\n'
<< "relative.empty(): " << relative.empty() << '\n';
}Ergebnis
base: docs joined: docs/./drafts/../guide.txt normal: docs/guide.txt relative: guide.txt first: docs absolute: false relative.empty(): false
Das Beispiel zeigt, dass `base` unverändert bleibt. Der verbundene Pfad enthält noch `.` und `..`; erst die Normalisierung entfernt sie. Der Weg von `docs` zum normalisierten Pfad lautet `guide.txt`.
Zugehörige Lektionen
- C++ · Lektion 48 · Fortgeschritten · Version: 3
Quellen
- C++ working draft: path non-member functions [fs.path.nonmember]
- C++ working draft: hidden friends [hidden.friends]
- C++ working draft: argument-dependent name lookup [basic.lookup.argdep]
- C++ working draft: path appends [fs.path.append]
- C++ working draft: path concatenation [fs.path.concat]
- C++ working draft: path generation [fs.path.gen]
- C++ working draft: path queries [fs.path.query]
- C++ working draft: path iterators [fs.path.itr]
- C++ working draft: generic pathname format [fs.path.generic]
- C++ working draft: filesystem error reporting [fs.err.report]
- cppreference: std::filesystem::operator/(std::filesystem::path)
- cppreference: std::filesystem::path::generic_string and related observers