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.15  Crawio                                                    TOS

 Name:         »Character raw input output« - Permit unbuffered 
               input/output.

 Opcode:       6

 Syntax:       int32_t Crawio ( int16_t w );

 Description:  The GEMDOS routine Crawio combines unbuffered console 
               input and output in one function. The following applies 
               for the parameter w, of which only the lower 8 bits are 
               significant (others should be 0):

                Value  Meaning

                0xff   Read character from standard input
                else   Output character to standard output

               Note: The function works correctly with input/output 
               redirection only as of GEMDOS Version 0.15.

 Return value: If the parameter w has the value 0xff, the function 
               returns a bit-array 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) will contain 
               the scancode of the keyboard, with Shift-key status in 
               the upper 8 bits provided bit 3 of the system variable 
               conterm is set. Note that if a non-ASCII key is 
               pressed, the ASCII-code returned will be 0. A return 
               value of 0 means that no character is available.

 Availability: All GEMDOS versions.

 Group:        Character input/output

 See also:     Binding   Cconin   Cconout   VT-52 terminal