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
- C++ working draft: path non-member functions [fs.path.nonmember]
- C++ working draft: hidden friends [hidden.friends]
- C++ working draft: argument-dependent name lookup [basic.lookup.argdep]
- C++ working draft: path appends [fs.path.append]
- C++ working draft: path concatenation [fs.path.concat]
- C++ working draft: path generation [fs.path.gen]
- C++ working draft: path queries [fs.path.query]
- C++ working draft: path iterators [fs.path.itr]
- C++ working draft: generic pathname format [fs.path.generic]
- C++ working draft: filesystem error reporting [fs.err.report]
- cppreference: std::filesystem::operator/(std::filesystem::path)
- cppreference: std::filesystem::path::generic_string and related observers