Click above to get retro games delivered to your door ever month!

 _gtWriteCon()
 Perform a console style write to the screen
------------------------------------------------------------------------------
 C Prototype

     #include "gt.api"
     ERRCODE _gtWriteCon(
                          BYTEP fpStr,
                          USHORT uiLen
                        )

 Arguments

     fpStr is the string to write.

     uiLen is the length of the string.

 Returns

     _gtWriteCon() returns zero if successful.  Any other value indicates an
     error.

 Description

     _gtWriteCon() writes a character string at the current cursor position
     using "console" style output.  This includes processing control
     characters, wrapping lines at the last column, and scrolling the screen
     at the last row.  This is similar to the CA-Clipper QQOUT() console
     function except that the output is always sent to the console.  The
     internal row and column coordinates are updated so the CA-Clipper
     functions, ROW() and COL(), will reflect the new cursor position.

 Examples

     .  In this simple example, _gtWriteCon() displays the string
        "Hello" on the screen:

        _gtWriteCon( "Hello", 5 )

 Files  Library is CLIPPER.LIB, header file is Gt.api.