# READ()

Syntax:

Then: bytes = READ(handle,destination,length)
Then: bytes = READ(handle,destination)

"handle" is the file handle returned by OPEN() or CREATE().
"destination" is the field to store the information.
"length" is the number of bytes to read.

"bytes" is the number of bytes read.

If length is not specified, the length of the destination field is used.

Return value
Returns the number of bytes read. 0 usually indicates end-of-file.

In a binary file, a return value of less than the request amount usually indicates that end-of-file has been reached. In a text file, it is possible to read fewer bytes than requested, even if EOF is not encountered.

Note: Destination must be a field, not an expression.

Version Ref: 4.5 (not included in filePro Lite)

Description:

Reads from a file.