CKTIS / C++
Paden samenvoegen met `/` in `std::filesystem`
De operator `/` geeft een nieuw pad terug zonder de operanden te wijzigen. De syntaxis van het rechterpad bepaalt of het aan het linkerpad wordt toegevoegd of dit geheel of deels vervangt.
Versie: 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"In <filesystem> verwijst de aanduiding std::filesystem::operator/ naar een operator om paden samen te voegen, niet naar een deling of een lidfunctie. Het is sinds C++17 een friend-functie in de naamruimte std::filesystem, geen lid van de klasse. De functie wordt gevonden via argumentafhankelijk zoeken (ADL), niet via gekwalificeerd zoeken. Schrijf base / "guide.txt" met base van het type path: de literal wordt omgezet naar path. Met alleen twee tekenreeksliteralen werkt / niet.
lhs / rhs past /= toe op een kopie van lhs en retourneert een path als waarde. De lidoperator /= wijzigt de linkeroperand en retourneert een referentie ernaar. += plakt de platformeigen padtekst aan elkaar zonder een scheidingsteken in te voegen. Als rhs absoluut is of een andere rootnaam heeft dan lhs, vervangt het het volledige linkerpad. Anders verwijdert een hoofdmap in rhs de hoofdmap en het relatieve gedeelte van het linkerpad, maar blijft de rootnaam behouden. Daarna wordt het rechterpad zonder zijn rootnaam toegevoegd, met het voorkeursscheidingsteken waar de regels dat vereisen. Zelfs een lege rechteroperand kan een afsluitend scheidingsteken toevoegen.
Samenvoegen normaliseert het pad niet. p.lexically_normal() geeft een nieuw pad terug waarin overbodige .-componenten worden verwijderd en paren zoals drafts/.. worden vereenvoudigd. p.lexically_relative(base) berekent het pad van base naar p zonder ze eerst te normaliseren. Bij de eerste controles geeft de functie een leeg pad terug, bijvoorbeeld als de rootnamen verschillen of als een bestandsnaam in het relatieve deel van een van beide paden als rootnaam kan worden geïnterpreteerd. Identieke reeksen componenten leveren alleen . op als de paden aan die controles voldoen.
p.is_absolute() test volgens de platformregels of het pad absoluut is: / op zichzelf is absoluut op POSIX, maar niet op Windows. p.empty() test of de generieke padnaam leeg is, niet of een map leeg is. p.begin() wijst naar de eerste padcomponent, niet naar een teken of een mapvermelding; voor een leeg pad geeft het p.end() terug. Gebruik geen iterators meer nadat p is vernietigd of nadat je een niet-const-lidfunctie op p hebt aangeroepen. p.generic_string() retourneert een std::string met / als scheidingsteken, zonder UTF-8 te garanderen.
Deze bewerkingen verwerken de padsyntaxis: ze controleren niet of bestanden bestaan en volgen geen symbolische koppelingen. Samenvoegen kan een uitzondering opleveren, bijvoorbeeld std::bad_alloc. Noch / noch lexically_normal() garandeert dat een onbetrouwbaar pad binnen de gekozen map blijft: wortels, .. of symbolische koppelingen kunnen die aanname onderuit halen.
Voorbeelden
#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';
}Resultaat
base: docs joined: docs/./drafts/../guide.txt normal: docs/guide.txt relative: guide.txt first: docs absolute: false relative.empty(): false
Het voorbeeld laat zien dat `base` niet verandert. Het samengevoegde pad bevat nog `.` en `..`; normalisatie verwijdert die. Het pad van `docs` naar het genormaliseerde pad is `guide.txt`.
Gerelateerde lessen
- C++ · Les 48 · Gevorderd · Versie: 3
Bronnen
- 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