c_cpp/etc/calc/help/fgetfield

   1 NAME
   2     fgetfield - read the next word from a file
   3
   4 SYNOPSIS
   5     fgetfield(fs)
   6
   7 TYPES
   8     fs          file stream open for reading
   9
  10     return      string or null
  11
  12 DESCRIPTION
  13
  14     Starting at the current file position, any whitespace
  15     characters are skipped.  If the reading reaches end-of-file, the
  16     null value is returned.  Otherwise the function returns the empty
  17     string "" if the first non-white character is '\0', and in other cases,
  18     the string formed by the non-white-space characters read until '\0' or
  19     a white-space character or te end of the file is reached.  In the
  20     cases where the reading is stopped by '\0' or white-space character,
  21     the file position will be that immediately after that character.
  22
  23 EXAMPLE
  24
  25     ; f = fopen("/tmp/junk", "w")
  26     ; fputs(f, " Alpha Beta \n")
  27     ; freopen(f, "r")
  28     ; fgetfield(f)
  29         "Alpha"
  30     ; fgetfield(f)
  31         "Beta"
  32     ; fgetfield(f)
  33
  34     ; freopen(f, "w")
  35     ; fputstr(f, " Alpha  ", "Beta")
  36     ; freopen(f, "r")
  37     ; fgetfield(f)
  38         "Alpha"
  39     ; fgetfield(f)
  40         ""
  41     ; fgetfield(f)
  42         "Beta"
  43
  44 LIMITS
  45     none
  46
  47 LINK LIBRARY
  48     none
  49
  50 SEE ALSO
  51     fgetstr, fputstr, fgets, fputs, fopen, files, fprintf
  52
  53 ## Copyright (C) 1999-2006  Landon Curt Noll
  54 ##
  55 ## Calc is open software; you can redistribute it and/or modify it under
  56 ## the terms of the version 2.1 of the GNU Lesser General Public License
  57 ## as published by the Free Software Foundation.
  58 ##
  59 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  60 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  61 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  62 ## Public License for more details.
  63 ##
  64 ## A copy of version 2.1 of the GNU Lesser General Public License is
  65 ## distributed with calc under the filename COPYING-LGPL.  You should have
  66 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  67 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  68 ##
  69 ## @(#) $Revision: 30.1 $
  70 ## @(#) $Id: fgetfield,v 30.1 2007/03/16 11:10:42 chongo Exp $
  71 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/fgetfield,v $
  72 ##
  73 ## Under source code control:   1996/04/30 03:05:17
  74 ## File existed as early as:    1996
  75 ##
  76 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  77 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/