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.2  Cauxis                                                     TOS

 Name:         »Character auxiliary input status« - Check the input 
               status of the serial port.

 Opcode:       18

 Syntax:       int16_t Cauxis ( void );

 Description:  The GEMDOS routine Cauxis checks the status of GEMDOS 
               handle 2 - normally the serial port aux: - to see 
               whether at least one character is waiting to be 
               received.

               Note: The function works correctly with redirection of 
               input/output only as of GEMDOS Version 0.15. Atari 
               recommends the use of the BIOS function Bconstat 
               instead.

 Return value: The function can return the following results:

                Value  Meaning

                -1     At least one character in buffer available
                0      No character available

 Availability: All GEMDOS versions.

 Group:        Character input/output

 See also:     Binding   Cauxos