CKTIS / C++
std::filesystem::path: lexicale padrepresentatie
std::filesystem::path bewaart syntaxis en elementen van een padnaam maar controleert zelf niet of een bestandssysteemobject bestaat of geldig is.
Versie: 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 uit <filesystem> representeert een optionele rootnaam, optionele rootmap en een reeks bestandsnamen. value_type, native formaat en preferred_separator zijn platformafhankelijk; generic_string() gebruikt de draagbare scheider /.
std::filesystem::path::empty test of de padnaam leeg is, terwijl std::filesystem::path::is_absolute hem volgens besturingssysteemregels classificeert; geen van beide bevraagt het bestandssysteem. std::filesystem::path::begin start iteratie over padelementen en std::filesystem::path::generic_string serialiseert het generieke formaat met /. std::filesystem::path::lexically_normal normaliseert syntaxis; std::filesystem::path::lexically_relative berekent een puur lexicale vorm ten opzichte van een basis en kan bij incompatibele wortels of absolute/relatieve vormen een leeg pad retourneren.
De scopeschrijfwijze std::filesystem::path::operator/ duidt de compositieverplichting aan, maar is in C++23 geen lidnaam: de werkelijke interface is het niet-lid std::filesystem::operator/, gelijkwaardig aan path(lhs) /= rhs. Hieruit mag geen lidalias worden afgeleid.
Operator / combineert padelementen volgens root- en scheidingsregels, terwijl operator+= alleen tekens aaneenplakt. Het voorbeeld bouwt logs/2026/run.txt en print bestandsnaam, extensie en bovenliggend logs/2026 in generiek formaat.
Dit is een lexicale klasse: een pad kan niet bestaan, ongeldig zijn voor de host of anders resolveren ten opzichte van de werkmap. lexically_normal verwijdert componenten syntactisch en volgt geen symlinks. operator== vergelijkt lexicale representaties, niet bestandsidentiteit; gebruik daarvoor filesystem::equivalent op bestaande objecten.
Voorbeelden
#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';
}
Resultaat
run.txt .txt logs/2026
std::filesystem::path → run.txt .txt logs/2026