std::filesystem::copy_symlink
Определён в заголовочном файле <filesystem> | ||
|---|---|---|
void copy_symlink( const std::filesystem::path& from,
const std::filesystem::path& to);
| (1) | (начиная с C++17) |
void copy_symlink( const std::filesystem::path& from,
const std::filesystem::path& to,
std::error_code& ec ) noexcept;
| (2) | (начиная с C++17) |
Копирует символическую ссылку в другое место.
1) Фактически вызывает
f(read_symlink(from), to), где f — это create_symlink или create_directory_symlink в зависимости от того, разрешается ли from в файл или каталог.
2) Фактически вызывает
f(read_symlink(from, ec), to, ec), где f — это create_symlink или create_directory_symlink в зависимости от того, разрешается ли from в файл или каталог.Параметры
| from | - | путь к символической ссылке для копирования |
| to | - | путь назначения новой символической ссылки |
| ec | - | выходной параметр для передачи сведений об ошибках в перегрузке, не генерирующей исключения |
Возвращаемое значение
(нет)
Исключения
Любая перегрузка, не помеченная noexcept, может выбросить std::bad_alloc при сбое выделения памяти.
1) При ошибках нижележащего API ОС выбрасывает
std::filesystem::filesystem_error, конструируемое с from в качестве первого аргумента-пути, to в качестве второго аргумента-пути и кодом ошибки ОС в качестве аргумента кода ошибки.
2) При сбое вызова API ОС записывает код ошибки API ОС в параметр
std::error_code&, а при отсутствии ошибок выполняет ec.clear().Пример
См. также
|
(C++17) | копирует файлы или каталоги (функция) |
|
(C++17) | копирует содержимое файла (функция) |
|
(C++17)(C++17) | создаёт символическую ссылку (функция) |
|
(C++17) | получает цель символической ссылки (функция) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/filesystem/copy_symlink
