c_cpp/etc/calc/help/fgetc

   1 NAME
   2     fgetc - read the next char from a file
   3
   4 SYNOPSIS
   5     fgetc(fd)
   6
   7 TYPES
   8     fd          file
   9
  10     return      str or nil
  11
  12 DESCRIPTION
  13     This function reads the next character from the open file
  14     associated with fd.
  15
  16     If there is a next character, this function returns a 1
  17     character string containing that character.  In the case
  18     of EOF or error, nil is returned.
  19
  20 EXAMPLE
  21     ; fd = fopen("/tmp/newfile", "w")
  22     ; fputs(fd, "chongo was here\n")
  23     ; fd2 = fopen("/tmp/newfile", "r")
  24     ; fgetc(fd2)
  25             "c"
  26
  27 LIMITS
  28     fd must be associated with an open file
  29
  30 LINK LIBRARY
  31     none
  32
  33 SEE ALSO
  34     errno, fclose, feof, ferror, fflush, fgetc, fgetline, fgets, files, fopen,
  35     fprintf, fputc, fputs, fseek, fsize, ftell, isfile, printf, prompt
  36
  37 ## Copyright (C) 1999  Landon Curt Noll
  38 ##
  39 ## Calc is open software; you can redistribute it and/or modify it under
  40 ## the terms of the version 2.1 of the GNU Lesser General Public License
  41 ## as published by the Free Software Foundation.
  42 ##
  43 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  44 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  45 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  46 ## Public License for more details.
  47 ##
  48 ## A copy of version 2.1 of the GNU Lesser General Public License is
  49 ## distributed with calc under the filename COPYING-LGPL.  You should have
  50 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  51 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  52 ##
  53 ## @(#) $Revision: 30.2 $
  54 ## @(#) $Id: fgetc,v 30.2 2013/03/27 06:08:56 root Exp $
  55 ##
  56 ## Under source code control:   1995/03/04 11:33:19
  57 ## File existed as early as:    1995
  58 ##
  59 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  60 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/