WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen