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-FileCconis()
Cconout()
Cconrs()
Cnecin()
Crawcin()
Bconin()
Cconin()                                                             GEMDOS

Syntax

LONG Cconin( VOID )

Function      Cconin() reads a character (waiting until one is available)
              from GEMDOS handle 0 (normally 'con:').

Opcode        1 (0x01)

Availability  All GEMDOS versions.

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

Return Value  The LONG value returned is a bit array arranged as follows:

              Bits 31-24      Bits 23-16      Bits 15-8       Bits 7-0

              Shift key       Keyboard        Unused          ASCII code
              status          scancode        (0)             of character
              (see below)

              The ASCII code of the character will be 0 if a non-ascii
              keyboard key is struck.

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.

Comments      The shift key status will only be returned when bit 3 of the
              system variable conterm (char *(0x484)) is set. This is
              normally not enabled. If the handle has been redirected, the
              inputted character will appear in the lower 8 bits of the
              return value.

See Also      Cconis(), Cconout(), Cconrs(), Cnecin(), Crawcin(), Bconin()