| Put Statement |
Named Arguments
No
Syntax
Put [#]filenumber, [recnumber], varname
filenumber
Use: Required
Data Type: Integer
Any valid file number.
recnumber
Use: Optional
Data Type: Variant (Long)
Record or byte number to begin the write operation.
varname
Use: Required
The name of the variable containing the data to be written to the file.
Description
Writes data from a program variable to a disk file.
Rules at a Glance
If filenumber is opened in random access mode, recnumber refers to the record number; if the file is opened in binary access mode, recnumber refers to a byte number.
Both bytes and records in a file are numbered from 1 upward.
If recnumber is omitted, the next byte or record to be written is placed at the position immediately after the position pointed to by the last Get or Put statement, or by the last Seek function. To omit recnumber, you must use the delimiting commas, as the following statement shows:
Put #1,,myVar
If you have opened the file in random mode, it's important to ensure that the record length specified in the Len clause of the Open statement matches the actual length of the data being written. If the length of the data being written is less than that specified by the Len clause, the space up to the end of the record is padded with the current contents of the file buffer—whatever that may be. If, on the other hand, the actual data length is more than that specified, an error occurs.
Certain data types complicate determining the actual data length ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access