База знанияИзпитен център
BGБългарски
Избери език13

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

Източници