Nj-Series Instructions Reference Manual (W502 - Omron NJ501-1500 Reference Manual

The following figure shows a programming example. Here, a text string of one line is read from a file, the
line feed code is deleted, and the result is written to pqr.
LD
FileGets_instance
A
Execute
abc FileID
TRUE
TrimLF
Related System-defined Variables
Name
_Card1Ready
_Card1Protect
_Card1Err
_Card1Access
_Card1PowerFail
Precautions for Correct Use
• Execution of this instruction is continued until processing is completed even if the value of Execute
changes to FALSE or the execution time exceeds the task period. The value of Done changes to
TRUE when processing is completed. Use this to confirm normal completion of processing.
• Refer to Using this Section on page 2-2 for a timing chart for Execute, Done, Busy, and Error.
• If the length of the one-line text string exceeds 1,986 bytes (with UTF-8 character codes, including
the final NULL character), the first 1,985 bytes of the text string are stored in Out with a NULL charac-
ter attached.

NJ-series Instructions Reference Manual (W502)

ST
FileGets_instance(A, abc, TRUE, def, ghi,
FileGets def
Done
ghi
Busy
jkl
Error
mno
ErrorID
pqr
Out
stu
EOF
Meaning
SD Memory Card
Ready Flag
SD Memory Card Write
Protected Flag
SD Memory Card Error
Flag
SD Memory Card
Access Flag
SD Memory Card
Power Interruption Flag
jkl, mno, pqr, stu);
Data type
BOOL This flag indicates if the SD Memory Card is
physically inserted and is mounted normally,
i.e., if it can be accessed by instructions and
communications commands.
TRUE: Can be used.
FALSE: Cannot be used.
BOOL This flag indicates if the SD Memory Card is
write protected when it is inserted and ready to
use.
TRUE: Write protected.
FALSE: Not write protected.
BOOL This flag indicates if an unspecified SD Memory
Card (e.g., an SDHC card) is mounted or if the
format is incorrect (i.e., not FAT16 or cor-
rupted).
TRUE: Error.
FALSE: No error.
BOOL This flag indicates if the SD Memory Card is
currently being accessed.
TRUE: Being accessed.
FALSE: Not being accessed.
BOOL This flag indicates if an error occurred in com-
pleting processing when power was interrupted
during SD Memory Card access. This flag is
not cleared automatically.
TRUE: Error.
FALSE: No error.
2 Instruction Descriptions
Description
2
2-827