READLINE()

 

Syntax:

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

 

"handle" is the file handle returned by OPEN() or CREATE().
"destination" is the field to store the information.
"length" is the maximum 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.

 

Version 6.0.01.07 - using "-1" for length to force read to EOL

Return value

The number of bytes read, not including the newline character.

 

Destination must be a field, not an expression.

 

Data is read from the file up to a maximum of length bytes, or until a newline character is encountered, whichever comes first. The newline character is discarded if encountered.

 

Version Ref:  4.5  (not included in filePro Lite)

 

Description:

Reads a line of text from a file.

 

Note: The file must be opened in text mode, or undefined behavior may result.