Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileCconout()
Cauxout()
Crawio()
Cprnout()
Bconout()
Fputchar()                                                           GEMDOS

Syntax

LONG Fputchar( handle, lchar, mode )
WORD handle;
LONG lchar;
WORD mode;

Function      Fputchar() writes a character to the specified file.

Opcode        264 (0x108)

Availability  This function is available under all MiNT versions
              integrated with MultiTOS.

Parameters    handle specifies the handle of the file to write a character
              to. If the file specified by handle is a pseudo-terminal
              then all four bytes of lchar are written (it should be
              formatted as a character read from Bconin() ), otherwise
              only the low byte of lchar is transmitted. mode is only
              valid if handle refers to a terminal device. If mode is
              TTY_COOKED (0x0001) then control characters (which could
              cause SIGINT or SIGTSTP signals to be raised) passed through
              this function will be interpreted and acted upon. Setting
              mode to 0 will cause control characters to have no special
              effect.

Binding       move.w   mode,-(sp)
              move.l   lchar,-(sp)
              move.w   handle,-(sp)
              move.w   #$108,-(sp)
              trap     #1
              lea      10(sp),sp

Return Value  Fputchar() returns 4L if the character was output to
              a terminal, 1L if the character was output to
              a non-terminal, 0L if the character could not be written
              (possibly because of flow control), EIHNDL (-37) if the
              handle was invalid, or a negative BIOS error code if an
              error occurred during I/O.

See Also      Cconout(), Cauxout(), Crawio(), Cprnout(), Bconout(),
              Fgetchar(), Fwrite()