30 Input/output library [input.output]

30.10 File systems [filesystems]

30.10.34 Filesystem operation functions [fs.op.funcs]

30.10.34.32 Rename [fs.op.rename]

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

1
#

Effects: Переименовывает old_­p в new_­p, как если бы POSIX rename().

[ Note:

  • (1.1)

    Если old_­p и new_­p разрешаются в один и тот же существующий файл, никаких действий не предпринимается.

  • (1.2)

    В противном случае переименование может включать следующие эффекты:

    • (1.2.1)

      если new_­p разрешается в существующий файл, не new_­p являющийся каталогом, удаляется; иначе,

    • (1.2.2)

      если new_­p разрешается в существующий каталог, new_­p удаляется, если он пуст в POSIX-совместимых операционных системах, но может быть ошибкой в ​​других операционных системах.

Сама символическая ссылка переименовывается, а не файл, в который она разрешается. ] — end note 

2
#

Throws: Как указано в [fs.err.report].