Метод Python3 os.replace

Python3 OS 文件/目录方法Методы файлов/каталогов Python3 OS

Обзор

Метод os.replace() используется для переименования файла или каталога.

Появилось в версии Python 3.3.

Синтаксис

replace()Синтаксис метода следующий:

os.replace(src, dst, *, src_dir_fd=None, dst_dir_fd=None)

Переименовать файл или каталог src в dst. Если dst — непустой каталог, будет возбуждено исключение OSError. Если dst существует и является файлом, он будет заменён, если у пользователя есть разрешение.

Parameters

  • src -- Исходный файл или каталог. Если файл или каталог не существует, будет возбуждено исключение FileNotFoundError.

  • dst -- Файл или каталог после переименования. Если он уже существует, он будет заменён напрямую.

  • src_dir_fd -- Путь относительно дескриптора каталога.

  • dst_dir_fd -- Путь относительно дескриптора каталога.

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

В случае успеха переименование будет атомарной операцией (это требование POSIX). При неудаче возвращается OSError.

Пример

Следующий пример демонстрирует использование метода replace():

Содержимое файла google.txt:

google

Пример

import os
 
# Переименовать файл или каталог
os.replace('google.txt','example.txt')

После выполнения останется только example.txt, с содержимым:

google

Если целевой файл dst уже существует, он будет заменён:

Содержимое файла test1.txt:

google

Содержимое файла test2.txt:

runnob

Пример

import os
 
# Переименовать файл или каталог
os.replace('test1.txt','test2.txt')

После выполнения останется только test2.txt, с содержимым:

google

Python3 OS 文件/目录方法Методы файлов/каталогов Python3 OS

Другие расширения