Método Python3 os.replace

Python3 OS 文件/目录方法Métodos de archivo/directorio de Python3 OS

Descripción general

El método os.replace() se utiliza para renombrar archivos o directorios.

Nueva característica en la versión Python 3.3.

Sintaxis

replace()El formato de sintaxis del método es el siguiente:

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

Renombra el archivo o directorio src a dst. Si dst es un directorio no vacío, se lanzará un OSError. Si dst existe y es un archivo, será reemplazado si el usuario tiene permisos.

Parámetros

  • src -- archivo o directorio de origen; si el archivo o directorio no existe, se lanzará un error FileNotFoundError.

  • dst -- archivo o directorio después del renombrado; si ya existe, será reemplazado directamente.

  • src_dir_fd -- ruta del descriptor de directorio relativo.

  • dst_dir_fd -- ruta del descriptor de directorio relativo.

Valor de retorno

Si la ejecución tiene éxito, el renombrado será una operación atómica (es un requisito de POSIX); si falla, retorna OSError.

Ejemplo

El siguiente ejemplo demuestra el uso del método replace():

El contenido del archivo google.txt es:

google

Ejemplo

import os
 
# Renombrar archivo o directorio
os.replace('google.txt','ejemplo.txt')

Después de la ejecución solo queda ejemplo.txt, con el siguiente contenido:

google

Si el archivo dst de destino ya existe, será reemplazado:

El contenido del archivo test1.txt es:

google

El contenido del archivo test2.txt es:

runnob

Ejemplo

import os
 
# Renombrar archivo o directorio
os.replace('test1.txt','test2.txt')

Después de la ejecución solo queda test2.txt, con el siguiente contenido:

google

Python3 OS 文件/目录方法Métodos de archivo/directorio de Python3 OS

Otras extensiones