Function: lread

Syntax

lread (<channel>, {<num>})

Type

string

Returns

A string value read from an IO channel. A complete line is read. At end-of-file, no message is displayed but funcerr is set to -1.

Parameters

• <channel>
  The channel from which to read. It must be open for reading.

• <num>
  Whether or not to treat comment lines (those beginning with a #) as data. The default is zero, i.e. ignore comment lines.

Examples

Open a channel to a text file and read the first line from it.

open ch,r,-if='names.dat'
string name = lread(ch)

See Also