Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje