packages/language/c/libc/stdio/v2_0/src/input/fgetc.cxx

   1 //===========================================================================
   2 //
   3 //      fgetc.cxx
   4 //
   5 //      ISO C standard I/O get character functions
   6 //
   7 //===========================================================================
   8 //####ECOSGPLCOPYRIGHTBEGIN####
   9 // -------------------------------------------
  10 // This file is part of eCos, the Embedded Configurable Operating System.
  11 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  12 //
  13 // eCos is free software; you can redistribute it and/or modify it under
  14 // the terms of the GNU General Public License as published by the Free
  15 // Software Foundation; either version 2 or (at your option) any later version.
  16 //
  17 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  18 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
  19 // FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  20 // for more details.
  21 //
  22 // You should have received a copy of the GNU General Public License along
  23 // with eCos; if not, write to the Free Software Foundation, Inc.,
  24 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  25 //
  26 // As a special exception, if other files instantiate templates or use macros
  27 // or inline functions from this file, or you compile this file and link it
  28 // with other works to produce a work based on this file, this file does not
  29 // by itself cause the resulting work to be covered by the GNU General Public
  30 // License. However the source code for this file must still be made available
  31 // in accordance with section (3) of the GNU General Public License.
  32 //
  33 // This exception does not invalidate any other reasons why a work based on
  34 // this file might be covered by the GNU General Public License.
  35 //
  36 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  37 // at http://sources.redhat.com/ecos/ecos-license/
  38 // -------------------------------------------
  39 //####ECOSGPLCOPYRIGHTEND####
  40 //===========================================================================
  41 //#####DESCRIPTIONBEGIN####
  42 //
  43 // Author(s):    jlarmour
  44 // Contributors:
  45 // Date:         2000-04-20
  46 // Purpose:      Provide the fgetc() function. Also provides the function
  47 //               version of getc() and getchar()
  48 // Description:
  49 // Usage:
  50 //
  51 //####DESCRIPTIONEND####
  52 //
  53 //===========================================================================
  54
  55 // CONFIGURATION
  56
  57 #include <pkgconf/libc_stdio.h>   // Configuration header
  58
  59 // INCLUDES
  60
  61 #include <cyg/infra/cyg_type.h>     // Common project-wide type definitions
  62 #include <cyg/infra/cyg_ass.h>      // Standard eCos assertion support
  63 #include <cyg/infra/cyg_trac.h>     // Standard eCos tracing support
  64 #include <stddef.h>                 // NULL and size_t from compiler
  65 #include <stdio.h>                  // header for this file
  66 #include <errno.h>                  // error codes
  67 #include <cyg/libc/stdio/stream.hxx>// Cyg_StdioStream
  68
  69 // FUNCTIONS
  70
  71 externC int
  72 fgetc( FILE *stream ) __THROW
  73 {
  74     Cyg_StdioStream *real_stream = (Cyg_StdioStream *)stream;
  75     cyg_ucount32 bytes_read;
  76     Cyg_ErrNo err;
  77     cyg_uint8 c;
  78
  79     CYG_REPORT_FUNCNAMETYPE("fgetc", "returning char %d");
  80     CYG_REPORT_FUNCARG1XV( stream );
  81
  82     CYG_CHECK_DATA_PTR( stream, "stream is not a valid pointer" );
  83
  84     err = real_stream->read( &c, 1, &bytes_read );
  85
  86     // Why do we need this?  Because the buffer might be empty.
  87     if (!err && !bytes_read) { // if no err, but nothing to read, try again
  88         err = real_stream->refill_read_buffer();
  89         if ( !err )
  90             err = real_stream->read( &c, 1, &bytes_read );
  91     } // if
  92
  93     CYG_ASSERT( (ENOERR != err) || (1 == bytes_read), "Didn't read 1 byte!" );
  94
  95     if (err)
  96     {
  97         if ( EAGAIN != err ) {
  98             real_stream->set_error( err );
  99             errno = err;
 100         }
 101         CYG_REPORT_RETVAL(EOF);
 102         return EOF;
 103     } // if
 104
 105     CYG_REPORT_RETVAL((int)c);
 106     return (int)c;
 107
 108 } // fgetc()
 109
 110
 111 // Also define getc() even though it can be a macro.
 112 // Undefine it first though
 113 #undef getchar
 114
 115 externC int
 116 getchar( void ) __THROW
 117 {
 118     return fgetc( stdin );
 119 } // getchar()
 120
 121
 122 // EXPORTED SYMBOLS
 123
 124 // Also define getc() even though it can be a macro.
 125 // Undefine it first though
 126 #undef getc
 127
 128 externC int
 129 getc( FILE * ) __THROW CYGBLD_ATTRIB_WEAK_ALIAS(fgetc);
 130
 131 // EOF fgetc.cxx