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.9.22  Fputchar                                                   TOS

 Name:         »Fputchar« - Zeichen in ein File ausgeben.

 Gemdosnummer: 264

 Deklaration:  int32_t Fputchar ( int16_t fh, int32_t ch, int16_t mode 
               );

 Beschreibung: Die Funktion schreibt ein Zeichen in die Datei mit dem 
               Handle fh. Der Parameter mode ist nur von Bedeutung, 
               wenn die Datei ein (Pseudo-)Terminal ist:

                mode  Bedeutung

                0     Raw-Mode
                      keine Auswertung der Sonderzeichen.
                1     Cooked-Mode
                      spezielle Kontrollzeichen (Control-C, Control-Z) 
                      werden gesucht und ggfs. interpretiert. Das 
                      selbe gilt für die Flußkontrolle (Control-S, 
                      Control-Q).

               Wenn die Datei ein (Pseudo-)Terminal ist, können alle 4 
               Bytes übertragen werden. Auf diese Art und Weise ist es 
               möglich, simulierte BIOS-Scancodes und Shift- 
               Statusmeldungen zu übertragen. Anderenfalls wird nur 
               das Low-Byte von ch übertragen.

 Ergebnis:     Die Funktion kann folgende Rückgabewerte liefern:

                4 :       Anzahl geschriebener Bytes, wenn Datei ein 
                          Terminal ist.
                1 :       Ausgabe erfolgreich, aber Datei ist kein 
                          Terminal.
                0 :       Bytes konnten nicht ausgegeben werden.
                EIHNDL :  ungültiges Datei-Handle.
                          Ein negativer BIOS Fehlercode, wenn ein I/O 
                          Fehler auftrat.

 Verfügbar:    Seit der ersten in MultiTOS integrierten MiNT Version 
               1.04.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Bconout   Cauxout   Cconout   Crawio 
               Fgetchar   Fwrite