Python3 os.replace-Methode

Python3 OS 文件/目录方法Python3 OS-Datei-/Verzeichnismethoden

Übersicht

Die Methode os.replace() wird verwendet, um eine Datei oder ein Verzeichnis umzubenennen.

Neu in Version Python 3.3.

Syntax

replace()Die Syntax der Methode lautet wie folgt:

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

Benennt die Datei oder das Verzeichnis src in dst um. Wenn dst ein nicht leeres Verzeichnis ist, wird ein OSError ausgelöst. Wenn dst existiert und eine Datei ist, wird sie ersetzt, wenn der Benutzer die Berechtigung dazu hat.

Parameters

  • src -- Quelldatei oder Quellverzeichnis. Wenn die Datei oder das Verzeichnis nicht existiert, wird ein FileNotFoundError ausgelöst.

  • dst -- Die Datei oder das Verzeichnis nach dem Umbenennen. Wenn es bereits existiert, wird es direkt ersetzt.

  • src_dir_fd -- Pfad relativ zum Verzeichnisdeskriptor.

  • dst_dir_fd -- Pfad relativ zum Verzeichnisdeskriptor.

Rückgabewert

Bei Erfolg ist die Umbenennung eine atomare Operation (dies ist eine POSIX-Anforderung). Bei einem Fehler wird ein OSError zurückgegeben.

Beispiel

Das folgende Beispiel demonstriert die Verwendung der Methode replace():

Der Inhalt der Datei google.txt ist:

google

Beispiel

import os
 
# Datei oder Verzeichnis umbenennen
os.replace('google.txt','example.txt')

Nach der Ausführung bleibt nur example.txt übrig, mit dem Inhalt:

google

Wenn die Zieldatei dst bereits existiert, wird sie ersetzt:

Der Inhalt der Datei test1.txt ist:

google

Der Inhalt der Datei test2.txt ist:

runnob

Beispiel

import os
 
# Datei oder Verzeichnis umbenennen
os.replace('test1.txt','test2.txt')

Nach der Ausführung bleibt nur test2.txt übrig, mit dem Inhalt:

google

Python3 OS 文件/目录方法Python3 OS-Datei-/Verzeichnismethoden

Andere Erweiterungen