Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::filesystem::path: leksykalna reprezentacja ścieżki

std::filesystem::path przechowuje składnię i elementy nazwy ścieżki, ale samo nie sprawdza istnienia ani poprawności obiektu w systemie plików.

Wersja: C++23

Składnia

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> reprezentuje sekwencję opcjonalnej nazwy korzenia, katalogu korzenia i nazw plików. Typ znaku value_type, format natywny oraz preferred_separator zależą od systemu; metody generic_string() używają przenośnego separatora /.

std::filesystem::path::empty sprawdza pusty zapis ścieżki, a std::filesystem::path::is_absolute klasyfikuje go według reguł systemu operacyjnego; żadna z tych operacji nie pyta systemu plików. std::filesystem::path::begin rozpoczyna iterację po elementach ścieżki, zaś std::filesystem::path::generic_string serializuje format ogólny z separatorem /. std::filesystem::path::lexically_normal normalizuje składnię, a std::filesystem::path::lexically_relative oblicza czysto leksykalną postać względem bazy i może zwrócić pustą ścieżkę dla niezgodnych korzeni lub postaci absolutnej/względnej.

Zapis zakresu std::filesystem::path::operator/ oznacza obowiązek składania obiektów path, lecz w C++23 nie jest nazwą składowej: właściwy interfejs to niebędący składową std::filesystem::operator/, równoważny path(lhs) /= rhs. Nie należy z tego zapisu wyprowadzać aliasu składowej.

Operator / składa elementy ścieżki z uwzględnieniem reguł korzenia i separatorów, podczas gdy operator+= jedynie dokleja znaki. Przykład buduje logs/2026/run.txt i drukuje nazwę pliku, rozszerzenie oraz logs/2026 w formacie ogólnym.

To klasa leksykalna: ścieżka może nie istnieć, być niepoprawna dla hosta albo różnie się rozstrzygać względem katalogu roboczego. lexically_normal usuwa składniki czysto składniowo i nie śledzi dowiązań. operator== porównuje reprezentacje leksykalne, nie tożsamość plików; do tej drugiej służy filesystem::equivalent na istniejących obiektach.

Przykłady

#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';
}

Wynik

run.txt .txt logs/2026

std::filesystem::path → run.txt .txt logs/2026

Źródła