2 Instruction Descriptions
2-826
NJ-series Instructions Reference Manual (W502)
FileGets
The FileGets instruction reads a text string of one line from the specified file in the SD Memory Card.
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 Tr im L F 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.
Instruction Name FB/FUN Graphic expression ST expression
FileGets Get Text String FB FileGets_instance(Execute,
FileID, TrimLF, Done, Busy,
Error, ErrorID, Out, EOF);
Variables
Name Meaning I/O Description Valid range Unit Default
FileID File ID
Input
ID of file to read
Depends on data type. ---
0
TrimLF Line feed
designation
Handling of the line feed
code of text string that was
read
TRUE: Delete.
FALSE: Do not delete.
FALSE
Out Read text
string
Output
Text string that was read
Depends on data type.
--- ---
EOF End of file Whether end of file was
reached
TRUE: Reached.
FALSE: Not reached.
Boolean
Bit strings Integers
Real
numbers
Times, durations,
dates, and text strings
BOOL
BYTE
WORD
DWORD
LWORD
USINT
UINT
UDINT
ULINT
SINT
INT
DINT
LINT
REAL
LREAL
TIME
DATE
TOD
DT
STRING
FileID OK
Tr im LF O K
Out OK
EOF OK
Function
FileGets
Execute Done
FileID Busy
TrimLF Error
ErrorID
Out
EOF
FileGets_instance
To Next Page
Loading...
