Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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