Löscht eine oder mehrere Dateien.
FileDelete, DateiMuster
Name einer Datei oder ein Platzhaltermuster wie C:\Temp\*.tmp
. Wenn kein absoluter Pfad angegeben ist, wird DateiMuster im A_WorkingDir-Verzeichnis vermutet.
Mit FileRemoveDir kann ein ganzer Ordner gelöscht werden, einschließlich seine Unterordner und Dateien.
[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.
ErrorLevel wird bei Misserfolg auf die Anzahl der Dateien gesetzt, die nicht gelöscht werden konnten, und bei Erfolg auf 0. Das Löschen eines Platzhaltermusters wie *.tmp
wird als Erfolg angesehen, auch dann, wenn keine Dateien gefunden wurden; folglich wird ErrorLevel auf 0 gesetzt.
Wenn Dateien gefunden wurden, wird A_LastError entweder auf Null (0) oder unmittelbar nach dem letzten Fehler auf das Ergebnis der Systemfunktion GetLastError() gesetzt. Ansonsten enthält A_LastError einen Fehlercode, der eventuell kenntlich macht, warum keine Dateien gefunden wurden.
Um eine schreibgeschützte Datei zu löschen, muss zuerst das Schreibschutzattribut entfernt werden. Zum Beispiel: FileSetAttrib, -R, C:\Meine Datei.txt
.
FileRecycle, FileRemoveDir, FileCopy, FileMove