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-FileCauxin()
Cauxout()
Cauxos()
Bconstat()
Cauxis()                                                             GEMDOS

Syntax

WORD Cauxis( VOID )

Function      Cauxis() indicates whether GEMDOS handle 2 (normally device
              'aux:') has at least one character waiting.

Opcode        18 (0x12)

Availability  All GEMDOS versions.

Binding       move.w   #$12,-(sp)
              trap     #1
              addq.l   #2,sp

Return Value  The return value will be DEV_READY (-1) if at least one
              character is available for reading or DEV_BUSY (0) if not.

Caveats       When using this function while its handle is redirected, an
              end-of-file condition will hang the system. GEMDOS version
              0.30 and all MiNT versions correct this bug. MiNT returns
              MINT_EOF (0xFF1A) when the end-of-file is reached. In
              addition, some 'C' compilers use this handle as a standard
              error device. It is therefore advisable to use Bconstat().

See Also      Cauxin(), Cauxout(), Cauxos(), Bconstat()