Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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