все Python 3osфункция

os.rename

os — переименование/перемещение

Переименовывает или перемещает файл/каталог.

Синтаксис

os.rename(src, dst)

Поведение при существующей цели зависит от системы: на Windows всегда FileExistsError, на Unix файл молча заменяется. Для переносимой замены есть os.replace. Между разными файловыми системами перенос может не пройти — для этого shutil.move. На POSIX удачное переименование атомарно, поэтому запись «во временный файл, потом rename» — стандартный способ обновить файл без полуготового состояния.

Примеры

import os
open('old.txt', 'w').close()
os.rename('old.txt', 'new.txt')   # переименование в том же каталоге
print(os.path.exists('new.txt'))   # → True
os.mkdir('folder_a')
os.rename('folder_a', 'folder_b')   # каталоги переименовываются тем же вызовом
print(os.path.isdir('folder_b'))   # → True

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности