CKTIS / C++
std::filesystem::path: лексикално представяне на път
std::filesystem::path пази синтаксиса и елементите на път, но сам не проверява дали обектът на файловата система съществува или е валиден.
Версия: C++23
Синтаксис
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 от <filesystem> представя незадължително име на корен, незадължителна коренова директория и последователност от имена. value_type, нативният формат и preferred_separator зависят от платформата; generic_string() използва преносимия разделител /.
std::filesystem::path::empty проверява дали пътят е празен, а std::filesystem::path::is_absolute го класифицира според правилата на операционната система; нито една операция не прави заявка към файловата система. std::filesystem::path::begin започва обхождане на елементите, а std::filesystem::path::generic_string сериализира общия формат с /. std::filesystem::path::lexically_normal нормализира синтаксиса; std::filesystem::path::lexically_relative изчислява чисто лексикална форма спрямо база и може да върне празен път при несъвместими корени или абсолютна/относителна форма.
Записът за обхват std::filesystem::path::operator/ означава задължението за съставяне на пътища, но в C++23 не е член: действителният интерфейс е нечленуващият std::filesystem::operator/, еквивалентен на path(lhs) /= rhs. От този запис не трябва да се извежда псевдоним на член.
Операторът / съставя елементи според правилата за корен и разделители, докато operator+= само долепя знаци. Примерът изгражда logs/2026/run.txt и извежда името, разширението и родителя logs/2026 в общ формат.
Това е лексикален клас: пътят може да не съществува, да е невалиден за хоста или да се разрешава различно спрямо работната директория. lexically_normal премахва компоненти синтактично и не следва връзки. operator== сравнява лексикални представяния, не идентичност на файлове; за нея използвайте filesystem::equivalent върху съществуващи обекти.
Примери
#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';
}
Резултат
run.txt .txt logs/2026
std::filesystem::path → run.txt .txt logs/2026