std::filesystem::rename

void rename( const std::filesystem::path& old_p,
             const std::filesystem::path& new_p );

void rename( const std::filesystem::path& old_p,
             const std::filesystem::path& new_p,
             std::error_code& ec ) noexcept;

Перемещает или переименовывает объект файловой системы, указанный в old_p, в new_p, как если бы это выполнялось с помощью POSIX-функции rename:

• Если old_p — файл, не являющийся каталогом, то new_p должен быть одним из следующих вариантов:
• тот же файл, что и old_p, или жёсткая ссылка на него: в этом случае ничего не происходит.
• существующий файл, не являющийся каталогом: сначала удаляется new_p, затем, не позволяя другим процессам увидеть new_p удалённым, путь new_p связывается с файлом, а old_p отвязывается от файла. Требуются права на запись в каталог, содержащий old_p, и в каталог, содержащий new_p.
• несуществующий файл в существующем каталоге: путь new_p связывается с файлом, а old_p отвязывается от файла. Требуются права на запись в каталог, содержащий old_p, и в каталог, содержащий new_p.
• Если old_p — каталог, то new_p должен быть одним из следующих вариантов:
• тот же каталог, что и old_p, или жёсткая ссылка на него: в этом случае ничего не происходит.
• существующий каталог: new_p удаляется, если он пуст, в POSIX-системах, но в других системах это может привести к ошибке. Если ошибки нет, сначала удаляется new_p, затем, не позволяя другим процессам увидеть new_p удалённым, путь new_p связывается с каталогом, а old_p отвязывается от каталога. Требуются права на запись в каталог, содержащий old_p, и в каталог, содержащий new_p.
• несуществующий каталог, имя которого не заканчивается разделителем каталогов и родительский каталог которого существует: путь new_p связывается с каталогом, а old_p отвязывается от каталога. Требуются права на запись в каталог, содержащий old_p, и в каталог, содержащий new_p.
• Символические ссылки не разыменовываются: если old_p — символическая ссылка, переименовывается она сама, а не её цель. Если new_p — существующая символическая ссылка, удаляется она сама, а не её цель.

Переименование завершается ошибкой, если

• new_p заканчивается на точку или две точки.
• new_p указывает на несуществующий каталог и заканчивается разделителем каталогов.
• old_p является каталогом, предком которого является new_p.

Параметры

Возвращаемое значение

(нет)

Исключения

Любая перегрузка, не помеченная noexcept, может выбросить std::bad_alloc при сбое выделения памяти.

Пример

#include <filesystem>
#include <fstream>
namespace fs = std::filesystem;

int main()
{
    std::filesystem::path p = std::filesystem::current_path() / "sandbox";
    std::filesystem::create_directories(p / "from");
    std::ofstream{ p / "from/file1.txt" }.put('a');
    std::filesystem::create_directory(p / "to");

//  fs::rename(p / "from/file1.txt", p / "to/"); // error: "to" is a directory
    fs::rename(p / "from/file1.txt", p / "to/file2.txt"); // OK
//  fs::rename(p / "from", p / "to"); // error: "to" is not empty
    fs::rename(p / "from", p / "to/subdir"); // OK

    std::filesystem::remove_all(p);
}

См. также