CKTIS / C++
Съединяване на пътища с `/` в `std::filesystem`
Операторът `/` връща нов път, без да променя операндите. Синтаксисът на десния път определя дали той ще се добави към левия, или ще го замени изцяло или частично.
Версия: ISO C++23; implementation support may vary
Синтаксис
#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"В <filesystem> означението std::filesystem::operator/ се отнася до оператор за съединяване на пътища, а не до деление или член-функция. Операторът е наличен от C++17 като приятелска функция, която не е член на класа, в пространството от имена std::filesystem. Тя се намира чрез търсене според аргументите (ADL), а не чрез квалифицирано търсене. Запиши base / "guide.txt", където base е от тип path: литералът се преобразува в path. Само два низови литерала не могат да се използват с /.
lhs / rhs прилага /= върху копие на lhs и връща path по стойност. Член-операторът /= променя левия операнд и връща референция към него, докато += долепя текста на пътя в платформения формат, без да вмъква разделител. Ако rhs е абсолютен или има различно име на корена от lhs, той заменя целия ляв път. В противен случай коренова директория в rhs премахва кореновата директория и относителната част на левия път, но запазва името на корена му. След това се добавя десният път без неговото име на корена, с предпочитания разделител там, където правилата го изискват. Дори празен десен операнд може да добави краен разделител.
Съединяването не нормализира пътя. p.lexically_normal() връща нов път, като премахва излишните компоненти . и опростява двойки като drafts/... p.lexically_relative(base) изчислява пътя от base до p, без предварителна нормализация. Още при началните проверки връща празен път, например ако имената на корените се различават или ако някое име на файл в относителната част на който и да е от двата пътя може да се тълкува като име на корен. При еднакви поредици от компоненти връща . само ако пътищата преминат тези проверки.
p.is_absolute() проверява дали пътят е абсолютен според правилата на платформата: самостоятелното / е абсолютен път в POSIX, но не и в Windows. p.empty() проверява дали записът на пътя в общ формат е празен, а не дали дадена директория е празна. p.begin() сочи първия компонент на пътя, не символ или запис в директория; за празен път връща p.end(). Не използвай итератори след унищожаването на p или след извикване на член-функция без const върху p. p.generic_string() връща std::string с разделители /, без гаранция за кодиране в UTF-8.
Тези операции обработват синтаксиса на пътя: не проверяват дали файловете съществуват и не разрешават символни връзки. Съединяването може да хвърли изключение, например std::bad_alloc. Нито /, нито lexically_normal() гарантира, че ненадежден път ще остане в избраната директория: корени, .. или символни връзки могат да нарушат това допускане.
Примери
#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';
}Резултат
base: docs joined: docs/./drafts/../guide.txt normal: docs/guide.txt relative: guide.txt first: docs absolute: false relative.empty(): false
Примерът показва, че `base` не се променя. Съединеният път още съдържа `.` и `..`; нормализацията ги премахва. Пътят от `docs` до нормализирания път е `guide.txt`.
Свързани уроци
- C++ · Урок 48 · Напреднало · Версия: 3
Източници
- 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