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