Méthode os.replace de Python3
Méthodes de fichiers/répertoires du module OS de Python3
Aperçu
La méthode os.replace() est utilisée pour renommer un fichier ou un répertoire.
Nouveau dans la version Python 3.3.
Syntaxe
replace()La syntaxe de la méthode est la suivante :
os.replace(src, dst, *, src_dir_fd=None, dst_dir_fd=None)
Renomme le fichier ou le répertoire src en dst. Si dst est un répertoire non vide, une OSError sera levée. Si dst existe et est un fichier, il sera remplacé si l'utilisateur en a la permission.
Parameters
src -- Fichier ou répertoire source. Si le fichier ou le répertoire n'existe pas, une FileNotFoundError sera levée.
dst -- Le fichier ou le répertoire après renommage. S'il existe déjà, il sera remplacé directement.
src_dir_fd -- Chemin relatif au descripteur de répertoire.
dst_dir_fd -- Chemin relatif au descripteur de répertoire.
Valeur de retour
En cas de succès, le renommage sera une opération atomique (c'est une exigence POSIX). En cas d'échec, une OSError est renvoyée.
Exemple
L'exemple suivant montre l'utilisation de la méthode replace() :
Le contenu du fichier google.txt est :
Exemple
# Renommer un fichier ou un répertoire
os.replace('google.txt','example.txt')
Après exécution, seul example.txt reste, avec le contenu :
Si le fichier de destination dst existe déjà, il sera remplacé :
Le contenu du fichier test1.txt est :
Le contenu du fichier test2.txt est :
runnob
Exemple
# Renommer un fichier ou un répertoire
os.replace('test1.txt','test2.txt')
Après exécution, seul test2.txt reste, avec le contenu :