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

 Name:         »Fputchar« - Write a character to a given file.

 Opcode:       264

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

 Description:  The function Fputchar writes a character to the file 
               with the handle fh. The parameter mode is only 
               significant if the file is a (pseudo-)terminal:

                mode  Meaning

                0     Raw mode
                      No evaluation of control characters
                1     Cooked mode
                      Special control characters (Control-C, Control- 
                      Z) will be looked for and interpreted if 
                      appropriate; the same applies for flow control 
                      (Control-S, Control-Q)

               If the file is a (pseudo-)terminal, then all 4 bytes 
               can be tranmitted. In this way it is possible to 
               transmit simulated BIOS scancodes and Shift-status 
               messages. Otherwise only the low byte of ch will be 
               transmitted.

 Return value: The function can return the following values:

                4 :       Number of written bytes, if the file is a 
                          terminal
                1 :       Output successful, but file is not a 
                          terminal
                0 :       Bytes could not be written (perhaps due to 
                          flow control)
                EIHNDL :  Invalid file handle
                          A negative BIOS error-code if an error 
                          occurred during I/O.

 Availability: As of the first in MultiTOS integrated MiNT version 
               1.04.

 Group:        File functions

 See Also:     Binding   Bconout   Cauxout   Cconout   Crawio 
               Fgetchar   Fwrite