CKTIS / C++
std::filesystem::path: lexikálna reprezentácia cesty
std::filesystem::path uchováva syntax a prvky cesty, ale sama nekontroluje existenciu ani platnosť objektu súborového systému.
Verzia: 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 z <filesystem> predstavuje voliteľný názov koreňa, voliteľný koreňový adresár a postupnosť názvov súborov. value_type, natívny formát a preferred_separator závisia od platformy; generic_string() používa prenosný oddeľovač /.
std::filesystem::path::empty testuje prázdny názov cesty, zatiaľ čo std::filesystem::path::is_absolute ho klasifikuje podľa pravidiel operačného systému; ani jedna operácia sa nepýta súborového systému. std::filesystem::path::begin začína iteráciu prvkov cesty a std::filesystem::path::generic_string serializuje všeobecný formát s /. std::filesystem::path::lexically_normal normalizuje syntax; std::filesystem::path::lexically_relative vypočíta čisto lexikálny tvar vzhľadom na bázu a pri nekompatibilných koreňoch či absolútnom/relatívnom tvare môže vrátiť prázdnu cestu.
Zápis rozsahu std::filesystem::path::operator/ označuje povinnosť skladania ciest, ale v C++23 nejde o člena: skutočným rozhraním je nečlenský std::filesystem::operator/, ekvivalentný path(lhs) /= rhs. Z tohto zápisu sa nesmie odvodiť členský alias.
Operátor / skladá prvky podľa pravidiel koreňa a oddeľovačov, zatiaľ čo operator+= iba zreťazí znaky. Príklad zostaví logs/2026/run.txt a vypíše názov, príponu a rodiča logs/2026 vo všeobecnom formáte.
Ide o lexikálnu triedu: cesta nemusí existovať, môže byť pre hostiteľa neplatná alebo sa vzhľadom na pracovný adresár preložiť inak. lexically_normal odstraňuje prvky syntakticky a nenasleduje odkazy. operator== porovnáva lexikálne reprezentácie, nie totožnosť súborov; na tú použite filesystem::equivalent na existujúcich objektoch.
Prí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ýsledok
run.txt .txt logs/2026
std::filesystem::path → run.txt .txt logs/2026