rom/dos/fputc.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8 #include <exec/memory.h>
   9 #include <proto/exec.h>
  10
  11 #include <dos/stdio.h>
  12 #include <dos/dosextens.h>
  13
  14 #include "dos_intern.h"
  15
  16 #include <aros/debug.h>
  17
  18 /*****************************************************************************
  19
  20     NAME */
  21 #include <proto/dos.h>
  22
  23         AROS_LH2(LONG, FPutC,
  24
  25 /*  SYNOPSIS */
  26         AROS_LHA(BPTR, file,      D1),
  27         AROS_LHA(LONG, character, D2),
  28
  29 /*  LOCATION */
  30         struct DosLibrary *, DOSBase, 52, Dos)
  31
  32 /*  FUNCTION
  33         Write a character to a file handle.
  34
  35         The write is buffered.
  36
  37         If the file handle is an interactive stream,
  38         the buffer is automatically flushed on a linefeed,
  39         carriage return or ASCII NUL.
  40
  41     INPUTS
  42         file      - Filehandle to write to.
  43         character - Character to write.
  44
  45     RESULT
  46         The character written or EOF in case of an error.
  47         IoErr() gives additional information in that case.
  48
  49     NOTES
  50         You should use Flush() when switching between
  51         buffered and unbuffered IO.
  52
  53     EXAMPLE
  54
  55     BUGS
  56
  57     SEE ALSO
  58         FGetC(), IoErr(), Flush(), FWrite()
  59
  60     INTERNALS
  61
  62 *****************************************************************************/
  63 {
  64     AROS_LIBFUNC_INIT
  65
  66     BYTE c = character;
  67     return (1 == FWriteChars(file, &c, 1, DOSBase))
  68         ? character
  69         : EOF;
  70
  71     AROS_LIBFUNC_EXIT
  72 } /* FPutC */