Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.16.5  Cconin                                                     TOS

 Name:         »character console input« - liest ein Zeichen vom 
               Standardeingabegerät.

 Gemdosnummer: 1

 Deklaration:  int32_t Cconin ( void );

 Beschreibung: Die GEMDOS-Routine Cconin wartet, bis ein Zeichen 
               verfügbar ist und liest ein Zeichen vom 
               Standardeingabegerät mit Handle 0. Als 
               Standardeingabegerät dient in der Regel die Tastatur.

               Hinweis: Durch Setzen von Bit-3 der Systemvariablen 
               conterm kann veranlaßt werden, daß in den Bits 24..31 
               der Wert von Kbshift zurückgegeben wird. Leider gibt es 
               keine Möglichkeit, Ein-/Ausgabeumlenkung sowie ein 
               Dateiende zu erkennen. Aus diesem Grund definieren 
               viele Bibliotheken die Tastenkombination Control-Z 
               (ASCII-Code 26) als Zeichen für das Dateiende.

 Ergebnis:     Die Funktion liefert als Ergebnis in einem LONG den 
               ASCII-Code des Zeichens im niederwertigen Wort (Bits 0 
               .. 7). Wenn das eingelesene Zeichen von der Tastatur 
               kommt, beinhalten die unteren acht Bits des 
               höherwertigen Worts (Bits 16 ... 23) den Scancode der 
               Tastatur mit dem Zustand der Shift Taste wie oben 
               beschrieben. Wenn eine Nicht-ASCII Taste gedrückt 
               wurde, wird als ASCII Code 0 zurückgeliefert.

 Verfügbar:    Alle GEMDOS Versionen.

 Gruppe:       Zeichenweise Ein-/Ausgabe

 Querverweis:  Binding   Cconout   Cconis   Kbshift