ICAM Virtual Machine V19 - Kxcad.net

It is good programming practice to close files when finished using them.
Writing to a Text File (WRITE)
Virtual Machine Reference, Model Customization
The Macro Language, Text File I/O from a Macro
The WRITE command writes a string into a text file. The syntax of the WRITE command is:
0:
n
WRITE/ unit ', format ' ,
� value �
See the “Output String Format Specifications” below for a description of how the string to be
written is constructed using the format argument.
Normally, a file must be opened before a write operation is attempted. This is true for units 20
through 29. All other units may be written to but may not be opened or read. It is important to
exercise caution when writing to units outside of the safe range (20 to 29). This is especially
important when considering the database files. These files are binary format and an inadvertent
write could corrupt your database. All I/O should be restricted to units 20 through 29.
Reading from a Text File (READ)
The READ command can be used to read a line from a text file into one or more macro variables.
The text file must be open when the READ is executed. The syntax of the READ from text
file command is:
INCR
READ/ unit
�
,
�
1:
n
� DECR �
', format ' ,
� �
� variable �
If INCR is specified, the next line is read. This is the default. A READ using INCR should only
be performed if “$FEOF(unit)” returns false. If DECR is specified, the last line is read again. If
no lines have been read yet, the first line is read.
See the “Input String Format Specifications” on page 142 for a description of how the variables
in the input list are assigned values from the input unit text using the format string.
Reading from a String Value (READ)
The READ command can also be used to do an “internal read” from a string value. The syntax of
the internal READ command is:
1 : n
� �
READ/ strvar ', format ' , variable
See the “Input String Format Specifications” on page 142 for a description of how the variables
in the input list are assigned values from the input string variable strvar using the format string.
ICAM Technologies Corporation – Proprietary 137