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