Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Łączenie ścieżek operatorem `/` w `std::filesystem`

Operator `/` tworzy nową ścieżkę bez zmiany argumentów. Składnia prawej ścieżki decyduje, czy zostanie ona dopisana, czy zastąpi część lub całość lewej.

Wersja: ISO C++23; implementation support may vary

Składnia

#include <filesystem>

// Friend declaration inside std::filesystem::path (not a member):
friend path operator/(const path& lhs, const path& rhs);

// Typical use, with base of type std::filesystem::path:
base / "guide.txt"

W <filesystem> etykieta std::filesystem::operator/ oznacza operator łączenia ścieżek, a nie dzielenie ani metodę klasy. Ta funkcja zaprzyjaźniona spoza klasy, dostępna od C++17, należy do std::filesystem i jest odnajdywana przez wyszukiwanie zależne od argumentów (ADL), nie przez wyszukiwanie kwalifikowane. Pisz base / "guide.txt", gdzie base jest typu path; literał zostanie przekonwertowany na path. Dwa same literały tekstowe nie działają z /.

lhs / rhs wykonuje /= na kopii lhs i zwraca path przez wartość. Składowy operator /= zmienia lewy argument i zwraca do niego referencję, a += skleja zapis natywny bez wstawiania separatora. Jeżeli rhs jest bezwzględna lub ma nazwę korzenia inną niż lhs, zastępuje całą lewą ścieżkę. W pozostałych przypadkach katalog główny w rhs usuwa katalog główny i część względną lewej ścieżki, lecz zachowuje jej nazwę korzenia. Następnie dopisywana jest prawa ścieżka bez nazwy korzenia, z preferowanym separatorem tam, gdzie wymagają tego reguły. Nawet pusta prawa ścieżka może dodać końcowy separator.

Łączenie nie normalizuje ścieżki. p.lexically_normal() zwraca nową ścieżkę, usuwając m.in. zbędne . i redukując pary typu drafts/... p.lexically_relative(base) wyznacza drogę od base do p, bez wcześniejszej normalizacji. Zwraca pustą ścieżkę już na etapie wstępnych sprawdzeń, na przykład gdy nazwy korzeni są różne lub gdy nazwę pliku w części względnej którejkolwiek ze ścieżek można zinterpretować jako nazwę korzenia. Dopiero po przejściu tych sprawdzeń identyczne sekwencje elementów dają wynik ..

p.is_absolute() sprawdza, czy ścieżka jest bezwzględna według reguł platformy; samo / jest bezwzględne na POSIX, ale nie na Windows. p.empty() sprawdza, czy zapis ścieżki w formacie ogólnym jest pusty, a nie czy katalog jest pusty. p.begin() wskazuje pierwszy element ścieżki, nie znak ani wpis katalogowy; dla pustej ścieżki zwraca p.end(). Nie używaj iteratorów po zniszczeniu p ani po wywołaniu na nim metody niebędącej const. p.generic_string() zwraca std::string z separatorami /, bez gwarancji kodowania UTF-8.

Te operacje przetwarzają zapis ścieżki: nie sprawdzają istnienia plików i nie rozwiązują dowiązań symbolicznych. Łączenie może zgłosić wyjątek, np. std::bad_alloc. Ani /, ani lexically_normal() nie gwarantuje, że ścieżka z niezaufanych danych pozostanie w wybranym katalogu: przeszkodą mogą być korzenie, .. lub dowiązania symboliczne.

Przykłady

#include <filesystem>
#include <iostream>

namespace fs = std::filesystem;

int main() {
    const fs::path base{"docs"};
    const fs::path joined = base / "./drafts/../guide.txt";
    const fs::path normal = joined.lexically_normal();
    const fs::path relative = normal.lexically_relative(base);

    std::cout << "base: " << base.generic_string() << '\n'
              << "joined: " << joined.generic_string() << '\n'
              << "normal: " << normal.generic_string() << '\n'
              << "relative: " << relative.generic_string() << '\n'
              << "first: " << normal.begin()->generic_string() << '\n'
              << std::boolalpha
              << "absolute: " << normal.is_absolute() << '\n'
              << "relative.empty(): " << relative.empty() << '\n';
}

Wynik

base: docs
joined: docs/./drafts/../guide.txt
normal: docs/guide.txt
relative: guide.txt
first: docs
absolute: false
relative.empty(): false

Przykład pokazuje, że `base` się nie zmienia. Wynik łączenia nadal zawiera `.` i `..`; dopiero normalizacja je usuwa. Droga od `docs` do znormalizowanej ścieżki to `guide.txt`.

Powiązane lekcje

  • C++ · Lekcja 48 · Zaawansowany · Wersja: 3

Źródła