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-FileCconin()Crawio()Bconin()Crawcin() GEMDOSSyntaxLONG Crawcin( VOID )
Function Crawcin() is similar to Cconout(), however it does not
process any special keys and does not echo the inputted
character.
Opcode 7 (0x07)
Availability All GEMDOSversions.
Binding move.w #$07,-(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 MiNTversions 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. Under normal circumstances, when GEMDOS handle 0
is being read from, no special system keys, including ctrl-c,
are checked.
See Also Cconin(), Crawio(), Bconin()