Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

Spájanie ciest pomocou `/` v `std::filesystem`

Operátor `/` vracia novú cestu bez zmeny operandov. Syntax pravej cesty určuje, či sa pripojí k ľavej ceste, alebo ju nahradí celú či len čiastočne.

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

Syntax

#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> označuje std::filesystem::operator/ operátor na spájanie ciest, nie delenie ani členskú funkciu. Od C++17 je dostupný ako nečlenská spriatelená funkcia v mennom priestore std::filesystem. Nájde sa vyhľadávaním závislým od argumentov (ADL), nie kvalifikovaným vyhľadávaním. V zápise base / "guide.txt" je base typu path a literál sa prevedie na path. Dva samotné reťazcové literály s / nefungujú.

lhs / rhs použije /= na kópiu lhs a vráti path hodnotou. Členský operátor /= zmení ľavý operand a vráti naň referenciu. Naopak, += zreťazí text ciest v natívnom formáte bez vloženia oddeľovača. Ak je rhs absolútna alebo má iný názov koreňa ako lhs, nahradí celú ľavú cestu. Inak koreňový adresár v rhs odstráni koreňový adresár a relatívnu časť ľavej cesty, ale zachová jej názov koreňa. Potom sa pripojí pravá cesta bez svojho názvu koreňa, s preferovaným oddeľovačom tam, kde to pravidlá vyžadujú. Aj prázdny pravý operand môže pridať koncový oddeľovač.

Spájanie cestu nenormalizuje. p.lexically_normal() vráti novú cestu: odstráni nadbytočné zložky . a zjednoduší dvojice ako drafts/... p.lexically_relative(base) vypočíta cestu z base do p bez predchádzajúcej normalizácie. Už pri úvodných kontrolách vráti prázdnu cestu, napríklad ak sa názvy koreňov líšia alebo ak sa niektorý názov súboru v relatívnej časti ktorejkoľvek cesty dá interpretovať ako názov koreňa. Pri zhodných postupnostiach zložiek vráti . len vtedy, ak cesty prejdú týmito kontrolami.

p.is_absolute() overuje, či je cesta absolútna podľa pravidiel platformy: samotné / je absolútne na POSIX, ale nie na Windows. p.empty() zisťuje, či je zápis cesty vo všeobecnom formáte prázdny, nie či je prázdny adresár. p.begin() ukazuje na prvú zložku cesty, nie na znak ani na položku adresára; pre prázdnu cestu vráti p.end(). Nepoužívaj iterátory po zániku p ani po zavolaní členskej funkcie bez const na p. p.generic_string() vráti std::string s oddeľovačmi / bez záruky kódovania UTF-8.

Tieto operácie pracujú so syntaxou ciest: neoverujú existenciu súborov a nevyhodnocujú symbolické odkazy. Spájanie môže vyvolať výnimku, napríklad std::bad_alloc. Ani /, ani lexically_normal() nezaručuje, že nedôveryhodná cesta zostane vo vybranom adresári: korene, .. alebo symbolické odkazy môžu tento predpoklad porušiť.

Príklady

#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';
}

Výsledok

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

Príklad ukazuje, že `base` sa nezmení. Spojená cesta stále obsahuje `.` a `..`; odstráni ich až normalizácia. Cesta z `docs` k normalizovanej ceste je `guide.txt`.

Súvisiace lekcie

  • C++ · Lekcia 48 · Pokročilá · Verzia: 3

Zdroje