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.5  Cconin                                                     TOS

 Name:         »Character console input« - Read a character from the 
               standard input device.

 Opcode:       1

 Syntax:       int32_t Cconin ( void );

 Description:  The GEMDOS routine Cconin reads a character from GEMDOS 
               handle 0 - normally the standard input device con: (the 
               keyboard as a rule), waiting until one is available.

               Note: By setting bit 3 of the system variable conterm 
               one can have the value of Kbshift returned in bits 
               24..31. Unfortunately there is no way to recognise 
               input/output redirection or end-of-file. That is why 
               many libraries define the key combination Control-Z 
               (ASCII-code 26) as the character for end-of-file.

 Return value: The function returns a LONG with the ASCII-code of the 
               character in the lower WORD (bits 0 .. 7). If the read 
               character originates from the keyboard, then the lower 
               8 bits of the higher WORD (bits 16 .. 23) contain the 
               scancode of the keyboard, with Shift-key status in the 
               upper 8 bits as mentioned above. Note that if a non- 
               ASCII key is pressed, the ASCII-code returned will be 
               0.

 Availability: All GEMDOS versions.

 Group:        Character input/output

 See also:     Binding   Cconout   Cconis   Kbshift