rom/dos/fgetc.c

   1 /*
   2     Copyright © 1995-2011, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: english
   7 */
   8
   9 #include <aros/debug.h>
  10 #include <exec/memory.h>
  11 #include <proto/exec.h>
  12
  13 #include <dos/stdio.h>
  14 #include <dos/dosextens.h>
  15
  16 #include "dos_intern.h"
  17
  18
  19 /*****************************************************************************
  20
  21     NAME */
  22 #include <proto/dos.h>
  23
  24         AROS_LH1(LONG, FGetC,
  25
  26 /*  SYNOPSIS */
  27         AROS_LHA(BPTR, file, D1),
  28
  29 /*  LOCATION */
  30         struct DosLibrary *, DOSBase, 51, Dos)
  31
  32 /*  FUNCTION
  33         Get a character from a buffered file. Buffered I/O is more efficient
  34         for small amounts of data but less for big chunks. You have to
  35         use Flush() between buffered and non-buffered I/O or you'll
  36         clutter your I/O stream.
  37
  38     INPUTS
  39         file   - filehandle
  40
  41     RESULT
  42         The character read or EOF if the file ended or an error happened.
  43         IoErr() gives additional information in that case.
  44
  45     NOTES
  46
  47     EXAMPLE
  48
  49     BUGS
  50
  51     SEE ALSO
  52         IoErr(), Flush()
  53
  54     INTERNALS
  55
  56 *****************************************************************************/
  57 {
  58     AROS_LIBFUNC_INIT
  59
  60     UBYTE c;
  61     LONG res;
  62
  63     res = vbuf_fetch(file, &c, 1, DOSBase);
  64
  65     if (res < 0)
  66         return EOF;
  67     else
  68         return c;
  69
  70     AROS_LIBFUNC_EXIT
  71 } /* FGetC */