CKTIS / C++
Spajanje putanja operatorom `/` u `std::filesystem`
Operator `/` vraća novu putanju bez promjene operanada. Sintaksa desne putanje određuje hoće li se ona dodati lijevoj ili će je zamijeniti djelomično ili u cijelosti.
Verzija: ISO C++23; implementation support may vary
Sintaksa
#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"U <filesystem> oznaka std::filesystem::operator/ označava operator za spajanje putanja, a ne dijeljenje ni člansku funkciju. Dostupan je od C++17 kao prijateljska funkcija koja nije član klase, u imenskom prostoru std::filesystem. Pronalazi se pretraživanjem ovisnim o argumentima (ADL), ne kvalificiranim pretraživanjem. Napiši base / "guide.txt" kada je base tipa path: literal se pretvara u path. Dva sama znakovna literala niza ne mogu se upotrijebiti s /.
lhs / rhs primjenjuje /= na kopiju lhs i vraća path po vrijednosti. Članski operator /= mijenja lijevi operand i vraća referencu na njega, dok += nadovezuje tekst putanje u izvornom formatu bez umetanja razdjelnika. Ako je rhs apsolutna ili ima drukčiji naziv korijena od lhs, zamjenjuje cijelu lijevu putanju. Inače korijenski direktorij u rhs uklanja korijenski direktorij i relativni dio lijeve putanje, ali zadržava njezin naziv korijena. Zatim se dodaje desna putanja bez svojeg naziva korijena, s preferiranim razdjelnikom ondje gdje ga pravila zahtijevaju. Čak i prazan desni operand može dodati završni razdjelnik.
Spajanje ne normalizira putanju. p.lexically_normal() vraća novu putanju, uklanja suvišne komponente . i pojednostavnjuje parove poput drafts/... p.lexically_relative(base) izračunava put od base do p bez prethodne normalizacije. Već pri početnim provjerama vraća praznu putanju, primjerice ako se nazivi korijena razlikuju ili ako se neki naziv datoteke u relativnom dijelu bilo koje od dviju putanja može protumačiti kao naziv korijena. Za jednake nizove komponenata vraća . samo ako putanje prođu te provjere.
p.is_absolute() provjerava je li putanja apsolutna prema pravilima platforme: sam / je apsolutan na POSIX-u, ali nije na Windowsu. p.empty() provjerava je li zapis putanje u generičkom formatu prazan, a ne je li direktorij prazan. p.begin() pokazuje na prvu komponentu putanje, a ne na znak ili stavku direktorija; za praznu putanju vraća p.end(). Ne upotrebljavaj iteratore nakon uništenja objekta p ni nakon poziva članske funkcije koja nije const na objektu p. p.generic_string() vraća std::string s razdjelnicima /, bez jamstva kodiranja UTF-8.
Te operacije obrađuju sintaksu putanje: ne provjeravaju postoje li datoteke i ne razrješavaju simboličke poveznice. Spajanje može baciti iznimku, primjerice std::bad_alloc. Ni / ni lexically_normal() ne jamče da nepouzdana putanja ostaje unutar odabranog direktorija: korijeni, .. ili simboličke poveznice mogu opovrgnuti tu pretpostavku.
Primjeri
#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';
}Rezultat
base: docs joined: docs/./drafts/../guide.txt normal: docs/guide.txt relative: guide.txt first: docs absolute: false relative.empty(): false
Primjer pokazuje da se `base` ne mijenja. Spojena putanja još sadrži `.` i `..`; normalizacija ih uklanja. Put od `docs` do normalizirane putanje je `guide.txt`.
Povezane lekcije
- C++ · Lekcija 48 · Napredno · Verzija: 3
Izvori
- 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