Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.17.8  Cconout                                                    TOS

 Name:         »Character console output« - Write one character to the 
               standard output device.

 Opcode:       2

 Syntax:       int32_t Cconout ( int16_t c );

 Description:  The GEMDOS routine Cconout writes the character c to 
               GEMDOS handle 1 - normally the standard output device 
               con: - as a rule the screen.

               Note: The character c contain the associated ASCII-code 
               in bits 0..7 (all other bits have to be 0). No line- 
               feed translation is done at the output, so ASCII 13 and 
               ACII 10 must be sent to start a new line. The function 
               works correctly with redirection of the input/output 
               only as of GEMDOS Version 0.15; with earlier versions, 
               do not redirect this handle to a write-only device 
               since the call tries to read from the output stream to 
               process the 'special' keys.

 Return value: The return value of the function depends on the 
               operating system. The following apply:

                Operating system   Value

                TOS                No sensible return value
                MagiC < 3.00
                                    < 0  = Error
                                    0L   = Output device is full
                                    1L   = Output was successful
                MiNT/MagiC > 3.00
                                    < 0  = Error
                                    0L   = Output device is full
                                    1L   = Output was successful
                                    4L   = Output to the terminal was 
                                         successful

 Availability: All GEMDOS versions.

 Group:        Character input/output

 See also:     BindingCconin   Cconos   VT52 terminal