Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

Spojování cest pomocí `/` v `std::filesystem`

Operátor `/` vrací novou cestu a nemění operandy. Podle syntaxe pravé cesty se buď připojí k levé, nebo nahradí její část či celou levou cestu.

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

Syntaxe

#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 pro spojování cest, nikoli dělení ani členskou funkci. Od C++17 je k dispozici jako nečlenská spřátelená funkce ve jmenném prostoru std::filesystem. Najde se vyhledáváním závislým na argumentech (ADL), nikoli kvalifikovaným vyhledáváním. V zápisu base / "guide.txt" je base typu path a literál se převede na path. Dva samotné řetězcové literály s / nefungují.

lhs / rhs použije /= na kopii lhs a vrátí path hodnotou. Členský operátor /= změní levý operand a vrátí na něj referenci. Naproti tomu += zřetězí text cest v nativním formátu bez vložení oddělovače. Je-li rhs absolutní nebo má jiný název kořene než lhs, nahradí celou levou cestu. Jinak kořenový adresář v rhs odstraní kořenový adresář a relativní část levé cesty, ale její název kořene zůstane zachován. Poté se připojí pravá cesta bez svého názvu kořene, s preferovaným oddělovačem tam, kde to pravidla vyžadují. I prázdný pravý operand může přidat koncový oddělovač.

Spojení cest neprovádí normalizaci. p.lexically_normal() vrátí novou cestu, odstraní nadbytečné složky . a zjednoduší dvojice jako drafts/... p.lexically_relative(base) vypočítá cestu z base do p bez předchozí normalizace. Už při úvodních kontrolách vrátí prázdnou cestu, například pokud se názvy kořenů liší nebo pokud lze některý název souboru v relativní části kterékoli z cest vyložit jako název kořene. Při shodné posloupnosti složek vrátí . jen tehdy, pokud cesty těmito kontrolami projdou.

p.is_absolute() ověří, zda je cesta absolutní podle pravidel platformy: samotné / je absolutní na POSIX, ale ne na Windows. p.empty() zjišťuje, zda je zápis cesty v obecném formátu prázdný, nikoli zda je prázdný adresář. p.begin() ukazuje na první složku cesty, nikoli na znak nebo položku adresáře; pro prázdnou cestu vrací p.end(). Nepoužívej iterátory po zániku p ani po zavolání členské funkce bez const na p. p.generic_string() vrátí std::string s oddělovači / bez záruky kódování UTF-8.

Tyto operace pracují se syntaxí cest: neověřují existenci souborů ani nevyhodnocují symbolické odkazy. Spojení cest může vyvolat výjimku, například std::bad_alloc. Ani /, ani lexically_normal() nezaručuje, že nedůvěryhodná cesta zůstane v určeném adresáři: kořeny, .. nebo symbolické odkazy mohou tento předpoklad porušit.

Pří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ýsledek

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

Příklad ukazuje, že `base` se nemění. Spojená cesta stále obsahuje `.` a `..`; odstraní je až normalizace. Cesta z `docs` k normalizované cestě je `guide.txt`.

Související lekce

  • C++ · Lekce 48 · Pokročilá · Verze: 3

Zdroje