PUT$$ statement  

Purpose

Writes a WIDE Unicode string to a file opened in binary mode.

Syntax

PUT$$ [#] filenum&, StrgExpr

Remarks

PUT$$ first evaluates the string expression.  If it results in an ANSI string, it is converted to WIDE Unicode characters.  PUT$$ then writes the WIDE string to the file specified by FileNum& at the current file pointer position.  GET$$ and PUT$$ provide a low-level alternative to sequential and random-access file processing techniques, allowing you to deal with files on a character by character basis.

File filenum& must have been opened in binary mode.  Characters are written starting at the current file pointer position, which can be set with the SEEK statement.  When the file is first opened, the pointer is at the beginning of the file (position 1, by default, unless BASE=0 was specified in the OPEN statement).  After PUT$$, the file pointer position is automatically advanced to the point which immediately follows the just written data.  You can use SEEK to retrieve or change the file pointer position.

Filenum&

The file number under which the file was opened.

StrgExpr

A string expression which is written to the file.

See also

GET, GET$, GET$$, OPEN, PUT, PUT$, SEEK function, SEEK statement, SETEOF, WRITE#