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);
}

См. также