CKTIS / C++
std::filesystem::path: lexikální reprezentace cesty
std::filesystem::path uchovává syntaxi a prvky cesty, ale sama nekontroluje existenci ani platnost objektu souborového systému.
Verze: C++23
Syntaxe
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 z <filesystem> představuje volitelný název kořene, volitelný kořenový adresář a posloupnost názvů souborů. value_type, nativní formát a preferred_separator závisejí na platformě; generic_string() používá přenositelný oddělovač /.
std::filesystem::path::empty testuje prázdný název cesty, zatímco std::filesystem::path::is_absolute jej klasifikuje podle pravidel operačního systému; ani jedna operace se nedotazuje souborového systému. std::filesystem::path::begin zahajuje iteraci prvků cesty a std::filesystem::path::generic_string serializuje obecný formát s /. std::filesystem::path::lexically_normal normalizuje syntaxi; std::filesystem::path::lexically_relative vypočte čistě lexikální tvar vzhledem k bázi a při nekompatibilních kořenech či absolutním/relativním tvaru může vrátit prázdnou cestu.
Zápis rozsahu std::filesystem::path::operator/ označuje povinnost skládání cest, ale v C++23 nejde o člena: skutečným rozhraním je nečlenský std::filesystem::operator/, ekvivalentní path(lhs) /= rhs. Z tohoto zápisu se nesmí odvodit členský alias.
Operátor / skládá prvky podle pravidel kořene a oddělovačů, zatímco operator+= pouze zřetězí znaky. Příklad sestaví logs/2026/run.txt a vypíše název, příponu a rodiče logs/2026 v obecném formátu.
Jde o lexikální třídu: cesta nemusí existovat, může být pro hostitele neplatná nebo se vzhledem k pracovnímu adresáři přeložit jinak. lexically_normal odstraňuje prvky syntakticky a nenásleduje odkazy. operator== porovnává lexikální reprezentace, ne totožnost souborů; pro ni použijte filesystem::equivalent na existujících objektech.
Příklady
#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';
}
Výsledek
run.txt .txt logs/2026
std::filesystem::path → run.txt .txt logs/2026