E r g e b n i s / R e s u l t
Löschen einer Datei innerhalb der akutellen Suchtabelle. Diese Funktion stellt OA4 im Programmierer nicht zur Verfügung.
B e s c h r e i b u n g / D e s c r i p t i o n
Die KILL-Funktion erlaubt dem User eine Datei in einem Verzeichnis der OA-Suchtabelle zu löschen. Die Datei wird ohne Rückfrage gelöscht. Mittels eines Parameters wird bestimmt, ob das erste Vorkommen der Datei oder die Datei in einem bestimmten Verzeichnis gelöscht werden soll.
Soll die Löschung bestätigt werden, so muss zunächt mittels EXISTS geprüft werden, ob die zu löschende Datei existiert. Nun kann anhand der Antwort von EXISTS ein Dialog zum User eingebaut werden und abhängig von seiner Antwort die KILL-Funktion ausgeführt werden.
S y n t a x
Code:
VALUE = CALL ( "KILL", [PFAD:]DATEINAME, TRUE/FALSE)
P a r a m e t e r
[PFAD:]DATEINAME = die zu löschende Datei
TRUE/FALSE = TRUE für erstes Vorkommen, FALSE für Datei im angegebenen Verzeichnis
R ü c k g a b e
Die Funktion gibt einen ganzzahligen Wert zurück:
-1 = es lag ein Parameter-Fehler vor
0 = es wurde keine Datei zum löschen gefunden
1 = die Datei wurde gelöscht
B e i s p i e l / E x a m p l e
a) - die Datei Text.txt im OA4-Verzeichnis löschen
Code:
INT ANTWORT = 0
ATTACH 'FILE'
ANTWORT = CALL ( 'KILL' , 'OA4:TEST.TXT' , FALSE )
GET ANTWORT
DETACH 'FILE'
b) - alle Dateien Text.txt in allen Verzeichnissen löschen
Code:
ATTACH 'FILE'
WHILE CALL ( 'KILL' , 'TEST.TXT' , TRUE ) > 0
END WHILE
DETACH 'FILE'
Q u e r v e r w e i s / R e f e r e n c e
EXISTS (prüft, ob eine Datei existiert)