Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileCconout()
Cconrs()
Cconws()                                                             GEMDOS

Syntax

WORD Cconws( str )
char *str;

Function      Cconws() writes a string to GEMDOS handle 1 (normally
              'con:').

Opcode        9 (0x09)

Availability  All GEMDOS versions.

Parameters    str is a pointer to a null-terminated character string to be
              written to the output stream.

Binding       pea      str
              move.w   #$09,-(sp)
              trap     #1
              addq.l   #6,sp

Return Value  Cconws() returns a WORD conatining the number of characters
              output or 0 if an error occurred.

Caveats       With GEMDOS versions below 0.15, this handle should not be
              redirected to a write-only device as the call attempts to
              read from the output stream to process special keys.

Comments      No line feed translation is performed on outputted
              characters so both an ASCII 13 and ASCII 10 must be sent to
              force a new line. In addition, the system checks for special
              keys so a ctrl-c embedded in the string will terminate the
              process.

See Also      Cconout(), Cconrs()