# WRITE()

Syntax:

Then: aa = WRITE(handle,source,length)
Then: aa = WRITE(handle,source)

where "handle" is the file handle returned by OPEN() or CREATE(), "source" is the data to write, and "length" is the number of bytes to write. If "length" is not specified, the length of the source field is used.

Return value

The number of bytes written.

Version Ref: 4.5 (not included in filePro Lite)

NOTE: In a text file, it is possible to write more bytes than specified. For a DOS text file a write of 10 bytes with a LF (line feed) character in it will cause 11 bytes to be written as the LF is converted to a CR/LF (carriage return, line feed pair). WRITELINE() is recommended for text files.

The write will be done to the current position in the file. This position can be set by SEEK(), otherwise it will be the byte immediately at the end of the last read/write operation.