charout()


>>-charout--(--+------+--+----------+--+-----------+--)--------><
               '-name-'  '-,--start-'  '-,--length-'

Function

Returns the number of characters remaining after an attempt to write string to the stream specified by name. The location for the next write is the current location increased by the number of characters written.

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 to be written to the stream specified byname.
start: For a persistent stream, specifies the byte number in the file where the write begins. start should not be specified for other types of streams.

Usage notes

If string is omitted, no data is written, 0 is returned, and the write location is set to the value start.
If start is also omitted, the write position is set to the end of file.

Example

To write the string to stdout:

call charout ,'hello world'esc_n

To set the write position to end:

call charout file