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
- 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