База знанияИзпитен център
BGБългарски
Избери език13

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

Източници