CKTIS / C++
std::filesystem::path: lexikalische Pfaddarstellung
std::filesystem::path speichert Syntax und Elemente eines Pfadnamens, prüft aber selbst weder Existenz noch Gültigkeit eines Dateisystemobjekts.
Version: C++23
Syntax
class std::filesystem::path {
public:
using value_type = /* operating-system-dependent */;
static constexpr value_type preferred_separator = /* operating-system-dependent */;
bool empty() const noexcept;
bool is_absolute() const;
std::string generic_string() const;
path lexically_normal() const;
path lexically_relative(const path& base) const;
iterator begin() const;
};
path std::filesystem::operator/(const path& lhs, const path& rhs);std::filesystem::path aus <filesystem> stellt optionalen Wurzelnamen, optionales Wurzelverzeichnis und eine Folge von Dateinamen dar. value_type, natives Format und preferred_separator sind plattformabhängig; generic_string() verwendet den portablen Trenner /.
std::filesystem::path::empty prüft auf einen leeren Pfadnamen, während std::filesystem::path::is_absolute ihn nach Betriebssystemregeln einordnet; keine Operation fragt das Dateisystem ab. std::filesystem::path::begin startet die Iteration über Pfadelemente, und std::filesystem::path::generic_string serialisiert das generische Format mit /-Trennern. std::filesystem::path::lexically_normal normalisiert die Syntax; std::filesystem::path::lexically_relative berechnet eine rein lexikalische Form relativ zu einer Basis und kann bei inkompatiblen Wurzeln oder Absolut-/Relativformen einen leeren Pfad liefern.
Die Scope-Schreibweise std::filesystem::path::operator/ bezeichnet die Pflicht zur Pfadzusammensetzung, ist in C++23 aber kein Membername: Die tatsächliche Schnittstelle ist der Nicht-Member std::filesystem::operator/, äquivalent zu path(lhs) /= rhs. Daraus darf kein Memberalias abgeleitet werden.
Operator / setzt Pfadelemente unter Beachtung von Wurzel- und Trennerregeln zusammen, operator+= hängt dagegen nur Zeichen an. Das Beispiel baut logs/2026/run.txt und gibt Dateiname, Erweiterung und den Elternpfad logs/2026 im generischen Format aus.
Dies ist eine lexikalische Klasse: Ein Pfad kann fehlen, für den Host ungültig sein oder relativ zum Arbeitsverzeichnis anders aufgelöst werden. lexically_normal entfernt Komponenten rein syntaktisch und folgt keinen Symlinks. operator== vergleicht lexikalische Darstellungen, nicht Dateiidentität; dafür dient filesystem::equivalent bei vorhandenen Objekten.
Beispiele
#include <filesystem>
#include <iostream>
int main() {
namespace fs = std::filesystem;
const fs::path value = fs::path{"logs"} / "2026" / "run.txt";
std::cout << value.filename().string() << ' '
<< value.extension().string() << ' '
<< value.parent_path().generic_string() << '\n';
}
Ergebnis
run.txt .txt logs/2026
std::filesystem::path → run.txt .txt logs/2026