file.rename

Home

4D v19.8

file.rename


file.rename ( newName ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
newName	Text	Neuer voller Name für File
Funktionsergebnis	Objekt	Umbenanntes File

Beschreibung

Die Methode file.rename benennt File mit dem in newName übergebenen Namen um und gibt das umbenannte Objekt File zurück.

Der Parameter newName muss die Namensregeln berücksichtigen (z.B. darf er nicht Zeichen wie ":", "/", etc. enthalten), sonst wird ein Fehler zurückgegeben. Gibt es bereits eine Datei mit demselben Namen, wird ein Fehler zurückgegeben.

Beachten Sie, dass die Methode den ganzen Namen der Datei ändert. Übergeben Sie in newName z.B. keine Endung, bekommt die Datei einen Namen ohne Endung.

Zurückgegebenes Objekt

Die Methode gibt das umbenannte Objekt File zurück.

Beispiel

Sie wollen "ReadMe.txt" umbenennen in "ReadMe_new.txt":

 $toRename:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)

 $newName:=$toRename.rename($toRename.name+"_new"+$toRename.extension)