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-FileBconstat()
Cconin()
Cauxin()
Bconin()                                                               BIOS

Syntax

LONG Bconin( dev )
WORD dev;

Function      Bconin() retrieves a character (if one is waiting) from the
              specified device.

Opcode        2 (0x02)

Availability  All TOS versions.

Parameters    dev specifies the device to read from as follows:

              Name           dev  Device

              DEV_PRINTER     0   Parallel port

              DEV_AUX         1   Auxillary device (normally the RS-232 port,
                                  however, TOS versions with Bconmap() can
                                  map in other devices to this handle)

              DEV_CONSOLE     2   Console device (keyboard)

              DEV_MIDI        3   MIDI Port

              DEV_IKBD        4   IKBD Controller (not available as an input
                                  device)

              DEV_RAW         5   Console device (keyboard)

              See Overview    6-  Additional devices (as available)

Binding       move.w   dev,-(sp)
              move.w   #$02,-(sp)
              trap     #13
              addq.l   #4,sp

Return Value  Bconin() returns a bit array arranged as follows:


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

              Shift key status    Keyboard       Reserved     ASCII value
              (see Kbshift() )    Scan Code        (0)

Comments      The shift key status is only returned if the system variable
              conterm (char *(0x484) ) has bit 3 set. This is normally
              disabled. Non-ASCII keys return 0 in bits 7-0.

See Also      Bconstat(), Cconin(), Cauxin()