• Home
• Funktionen/Funktionsbausteine - Referenz
• Erweiterte Funktionen und Funktionsbausteine
• Dateizugriff
• FILE_REMOVE

FILE_REMOVE

Typ	Funktionsbaustein
Beschreibung	Löscht eine Datei. Vor dem Löschen muss die Datei mit dem Funktionsbaustein FILE_CLOSE geschlossen werden. Geben Sie den Namen der zu löschenden Datei am Eingang NAME (Datentyp STRING) an. Der Funktionsbaustein wird mit einer steigenden Flanke am Eingang Execute aktiviert. Die Ausführung des Funktionsbausteins ist abgeschlossen, wenn der Ausgang Done auf 1 gesetzt wird. Tritt bei der Ausführung ein Fehler auf, wird der Ausgang Error auf 1 gesetzt. Die ErrorID gibt die Nummer der Fehlerursache an.
Hinweise	Die Variable mit dem Dateinamen muss vom Datentyp STRING sein. Die Länge des Dateinamens darf einschließlich Pfad 80 Zeichen nicht überschreiten. Es sind keine anwenderdefinierten Zeichenfolgen erlaubt. Bei PLCnext Technology-Steuerungen ist das Standardverzeichnis /opt/plcnext, (Wenn Sie über SFTP oder SSH mit der Steuerung verbunden sind, ist dies auch das Standardverzeichnis.) Enthält der Dateiname keine Angaben zum Verzeichnis, wird in diesem Verzeichnis nach der Datei gesucht bzw. die Datei erzeugt. Ein relativer Pfad im Verzeichnisnamen muss sich auch auf dieses Verzeichnis beziehen. Der Status der Ausgänge Done, Error und ErrorID bleibt solange erhalten, bis am Eingang Execute eine fallende Flanke erkannt wird. Das Fehlerverhalten des Funktionsbausteins kann abhängig vom System, auf dem die Anwendung mit dem Aufruf des Funktionsbausteins ausgeführt wird, unterschiedlich sein. Wenn der Funktionsbaustein für eine bereits geöffnete Datei aufgerufen wird, ist folgendes Verhalten möglich: Die Datei wurde nicht gelöscht. Wie erwartet wird der Ausgang Error auf TRUE gesetzt. Am Ausgang ErrorID wird die Fehlernummer 21 ausgegeben. Oder Die Datei wurde gelöscht (es wird kein Fehler gemeldet). Das Datei-Handle ist weiterhin gültig. Funktionsbausteine müssen instanziiert werden. Der FB-Instanzname muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll. Der Instanzname muss innerhalb der POE eindeutig sein.
Parameter	Eingänge Execute Datentyp: BOOL Beschreibung: Löscht die Datei bei einer steigenden Flanke. Name Datentyp: STRING Beschreibung: Name der Datei, die gelöscht werden soll, einschließlich des Pfades. Sehen Sie hierzu auch die unten stehenden Hinweise zu den Dateiverzeichnissen. Ausgänge Done Datentyp: BOOL Beschreibung: 0 Der Funktionsbaustein wurde nicht ausgeführt. 1 Der Funktionsbaustein wurde ausgeführt. Error Datentyp: BOOL Beschreibung: 0 Beim Löschen der Datei ist kein Fehler aufgetreten. 1 Beim Löschen der Datei ist ein Fehler aufgetreten. ErrorID Datentyp: UINT Beschreibung: Fehlernummer des beim Löschen der Datei aufgetretenen Fehlers: 0 Keine Fehlerinformationen vorhanden. 6 Dateiname nicht angegeben. 21 Datei konnte nicht gelöscht werden.