| Typ | Funktionsbaustein |
| Beschreibung | Positioniert den aktuellen Dateizeiger an einer neuen Position in einer Datei.Geben Sie das gültige Datei-Handle der zu verarbeitenden Datei am Eingang Handle an. Das Datei-Handle wird erzeugt, wenn die Datei zuvor mit dem Funktionsbaustein FILE_OPEN geöffnet wurde.
Der relative Offset, der für das Verschieben des Dateizeigers verwendet werden soll, wird am Eingang Position angegeben. Die Position, die als Referenz beim Verschieben verwendet werden soll, wird am Eingang Mode definiert (siehe Beschreibung des Eingangs).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 |
- Der Status der Ausgänge Done, Error und ErrorID bleibt solange erhalten, bis am Eingang Execute eine fallende Flanke erkannt wird.
- Eine Position kann auch nach dem Dateiende gesetzt werden. Beim Schreiben der Position wird die Lücke zwischen dem Dateiende und der aktuellen Schreibposition mit Nullen aufgefüllt.
- 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: | Setzt die neue Position des Dateizeigers bei einer steigenden Flanke. |
Handle
| Datentyp: | UINT |
| Beschreibung: | Datei-Handle der Datei, in der die Position gesetzt werden soll. |
Position
| Datentyp: | ANY_INT |
| Beschreibung: | Neue Position innerhalb der Datei. |
Mode
| Datentyp: | ANY_INT |
| Beschreibung: | Positionierungsmodus
| 0, sonstige Werte | Positionierung relativ zum Dateianfang. |
| 1 | Positionierung relativ zur aktuellen Position. |
| 2 | Positionierung relativ zum Dateiende. |
|
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 Setzen der Position ist kein Fehler aufgetreten. |
| 1 | Beim Setzen der Position ist ein Fehler aufgetreten. |
|
ErrorID
| Datentyp: | UINT |
| Beschreibung: | Fehlernummer des beim Setzen der Position aufgetretenen Fehlers:
| 0 | Keine Fehlerinformationen vorhanden. |
| 1 | Ungültiges Datei-Handle. |
| 13 | Ungültige Position. |
| 24 | Die Position konnte nicht gesetzt werden. |
|
|