Filegets - Omron NJ501-1500 Reference Manual

2 Instruction Descriptions

FileGets

The FileGets instruction reads a text string of one line from the specified file in the SD Memory Card.
Instruction
FileGets Get Text String
Variables
Name Meaning
FileID File ID
TrimLF Line feed
designation
Out Read text
string
EOF End of file
Bit strings
FileID
TrimLF OK
Out
EOF OK
Function
The FileGets instruction reads a text string of one line from the file position indicator in the file specified
by file ID FileID in the SD Memory Card. The file position indicator is set at the desired location in
advance with the FileSeek instruction. Line endings are determined by a line feed code. The text string
that is read is written to read text string Out. The following three line feeds are automatically detected:
CR, LF, and CR+LF. If line feed designation TrimLF is TRUE, the line feed code is deleted from the text
string before it is written to Out. If data is read to the end of the file, end of file EOF changes to TRUE.
Otherwise, the value of EOF will be FALSE.
2-826
Name FB/FUN
FB
I/O Description
ID of file to read
Handling of the line feed
code of text string that was
Input
read
TRUE: Delete.
FALSE: Do not delete.
Text string that was read
Whether end of file was
Output
reached
TRUE: Reached.
FALSE: Not reached.
OK
Graphic expression
FileGets_instance
FileGets
Execute Done
FileID Busy
TrimLF Error
ErrorID
Out
EOF
Valid range
Depends on data type.
Depends on data type.
Integers
NJ-series Instructions Reference Manual (W502)
ST expression
FileGets_instance(Execute,
FileID, TrimLF, Done, Busy,
Error, ErrorID, Out, EOF);
Unit Default
0
FALSE
---
--- ---
Times, durations,
dates, and text strings
OK