lineout()


>>-lineout--(--+------------------------------+--)-------------><
               '-name--+--------------------+-'      
                       '-,string-+--------+-'        
                                 '-,start-'

Function

Returns 1 line or 0 lines that are remaining to be written after an attempt to write string to the stream specified by name. A newline character is written following string. If an error occurs on the write, some data may be written to the stream, and the function returns the value 1.

Parameters

name: The name for the stream can be a path name or a string that was returned from the stream open or popen commands. If name is omitted, the standard output stream is used.
string: Data that is to be written to the stream specified by name. If string is omitted, no data is written, 0 is returned, and the write position is set based on the value of start. If both string and start are omitted, the write position is set to the beginning of the file.
start: For a persistent stream, this argument can have the value 1, to begin writing at the beginning of the stream. No other value for start is supported. Do not specify start for other types of streams.

Example

to write the line to stdout:

call lineout ,'hello world'