FB_FileGets
Der Funktionsbaustein liest Strings aus einer Datei. Der String wird bis zum Zeilenvorschub-Character und inklusive des Zeilenvorschub-Characters oder bis zum Ende der Datei oder bis zur maximal zulässigen Länge von sLine gelesen. Die Null-Terminierung wird automatisch angehängt. Die Datei muss dafür im Textmodus geöffnet worden sein.
VAR_INPUT
VAR_INPUT
sNetId : T_AmsNetId;
hFile : UINT;
bExecute : BOOL;
tTimeout : TIME;
END_VAR
sNetId : Ist ein String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.
hFile : Datei-Handle.
bExecute : Durch eine steigende Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.
tTimeout : Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrId : UDINT;
sLine : T_MaxString;
bEOF : BOOL;
END_VAR
bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError: Sollte ein ADS-Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.
nErrId: Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.
sLine : Der gelesene String.
bEOF : Ist diese Variable gesetzt, dann wurde das Dateiende erreicht und keine weiteren Datenbytes konnten gelesen werden (cbRead=0). Dieser Ausgang wird nicht gesetzt wenn noch einige Datenbytes gelesen werden konnten (cbRead>0).
Function specific ADS error code | Possible reason |
|---|---|
0x703 | Invalid or unknown file handle. |
0x70A | No memory for read buffer. |
0x70E | File was opened with wrong method ( e.g. with 'obsolete' FILEOPEN function block ). |
Beispiel für den Aufruf des Bausteins in FBD:
PROGRAM Test
VAR
fbFileGets : FB_FileGets;
hFile : UINT;
bFileGets : BOOL;
bFileGetsBusy : BOOL;
bFileGetsError : BOOL;
nFileGetsErrorId: UDINT;
strBuffer : STRING;
bFileGetsEOF :BOOL;
END_VAR
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
|---|---|---|
TwinCAT v2.8.0 | PC or CX (x86) | TcSystem.Lib |
TwinCAT v2.10.0 Build >= 1301 | CX (ARM) | TcSystem.Lib |