Specifications

Chapter 14. Statement Reference
306
Syntax:
PUT [#]filenumber[,recordnumber]
Parameter:
filenumber
A numeric expression which returns a value from 1 to 16.
recordnumber
A numeric expression which returns a value from 1 to 32767.
Description:
PUT writes a record from a field variable(s) declared by the FIELD statement to a
data file specified by
filenumber.
•
filenumber is the number of a data file opened by the OPEN statement.
•
recordnumber is the record number where the data is to be placed in a data
file.
It should be within the range from 1 to the maximum number of registrable
records (
filelength) specified by the OPEN statement (when a new data file
is created).
• If
recordnumber option is omitted, the default record number is one more than
the last record written.
• Record numbers to be specified do not have to be continuous. If you specify
record number 10 when records 1 through 7 have been written, for example, then
the
PUT statement automatically creates records 8 and 9 filled with spaces and
then writes data to record 10.
• If the actual data length of a field variable is longer than the field width specified
by the
FIELD statement, then the excess is truncated from the right end column.
• Since data in a data file is treated as text data (ASCII strings), numeric data
should be converted into the proper string form with the
STR$ function before
being assigned to a field variable.
• The
PUT statement cannot write data to files opened as read-only by specifying
drive B in the OPEN statement.
File I/O statement
PUT
Writes a record from a field variable to a data file.