-

FILE_TELL

TypFunktionsbaustein
BeschreibungErmittelt die aktuelle Position des Dateizeigers in einer Datei.

Das gültige Handle der Datei, in der die aktuelle Position des Dateizeigers bestimmt werden soll (relativer Offset vom Dateianfang), wird an den Eingang Handle angelegt. Das Datei-Handle wird erzeugt, wenn die Datei zuvor mit dem Funktionsbaustein FILE_OPEN geöffnet wurde.

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. Die aktuelle Position des Dateizeigers wird am Ausgang Position nach erfolgreicher Ausführung zurückgeliefert.

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, Position, Error und ErrorID bleibt solange erhalten, bis am Eingang Execute eine fallende Flanke erkannt wird.
  • 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.
ParameterEingänge

Execute

Handle

Ausgänge

Done

Position

Error

ErrorID