CKTIS / C++
Združevanje poti z `/` v `std::filesystem`
Operator `/` vrne novo pot, ne da bi spremenil operanda. Skladnja desne poti določa, ali se ta doda levi poti ali pa jo delno oziroma v celoti nadomesti.
Različica: 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"V <filesystem> oznaka std::filesystem::operator/ pomeni operator za združevanje poti, ne deljenja ali članske funkcije. Od C++17 je na voljo kot nečlanska prijateljska funkcija v imenskem prostoru std::filesystem. Najde jo iskanje, odvisno od argumentov (ADL), ne kvalificirano iskanje. Zapiši base / "guide.txt", kjer je base tipa path: literal se pretvori v path. Samo dva nizovna literala z / ne delujeta.
lhs / rhs uporabi /= na kopiji lhs in vrne path po vrednosti. Članski operator /= spremeni levi operand in vrne referenco nanj, medtem ko += stakne besedilo poti v izvornem zapisu brez vstavljanja ločila. Če je rhs absolutna ali ima drugačno ime korena kot lhs, nadomesti celotno levo pot. Sicer korenski imenik v rhs odstrani korenski imenik in relativni del leve poti, vendar ohrani njeno ime korena. Nato se doda desna pot brez njenega imena korena, s prednostnim ločilom tam, kjer to zahtevajo pravila. Tudi prazen desni operand lahko doda končno ločilo.
Združevanje poti ne normalizira. p.lexically_normal() vrne novo pot, odstrani odvečne komponente . in poenostavi pare, kot je drafts/... p.lexically_relative(base) izračuna pot od base do p brez predhodne normalizacije. Že pri začetnih preverjanjih vrne prazno pot, na primer če se imeni korenov razlikujeta ali če je mogoče katero od imen datotek v relativnem delu katere koli od obeh poti razlagati kot ime korena. Pri enakih zaporedjih komponent vrne . le, če poti prestaneta ta preverjanja.
p.is_absolute() preveri, ali je pot absolutna po pravilih platforme: / sama je absolutna na POSIX, ne pa na Windows. p.empty() preveri, ali je zapis poti v splošni obliki prazen, ne pa, ali je imenik prazen. p.begin() kaže na prvo komponento poti, ne na znak ali vnos v imeniku; za prazno pot vrne p.end(). Iteratorjev ne uporabljaj po uničenju p ali po klicu članske funkcije brez const na p. p.generic_string() vrne std::string z ločili /, ne zagotavlja pa kodiranja UTF-8.
Te operacije obdelujejo skladnjo poti: ne preverjajo obstoja datotek in ne razrešujejo simbolnih povezav. Združevanje lahko sproži izjemo, na primer std::bad_alloc. Niti / niti lexically_normal() ne zagotavlja, da nezaupanja vredna pot ostane v izbranem imeniku: koreni, .. ali simbolne povezave lahko ovržejo to predpostavko.
Primeri
#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
Primer pokaže, da se `base` ne spremeni. Združena pot še vedno vsebuje `.` in `..`; odstrani ju šele normalizacija. Pot od `docs` do normalizirane poti je `guide.txt`.
Povezane lekcije
- C++ · Lekcija 48 · Napredna · Različica: 3
Viri
- 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