c_cpp/etc/calc/help/rewind

   1 NAME
   2     rewind - set position at the beginning of some or all files
   3
   4 SYNOPSIS
   5     rewind([f_1, f_2, ...])
   6
   7 TYPES
   8     f_1, f_2, ...       open file streams
   9
  10     return              null value or error
  11
  12 DESCRIPTION
  13     With one or more arguments f_1, ..., this function sets the
  14     position for each f_i at the beginning.  With no argument,
  15     this operation is applied to all user-opened files.
  16
  17 EXAMPLE
  18     ; f = fopen("curds","r");
  19     ; x = fgetc(f);
  20     ; rewind(f);
  21     ; y = fgetc(f);
  22     ; print x == y
  23     1
  24
  25 LIMITS
  26     The number of arguments is not to exceed 1024.
  27
  28 LINK LIBRARY
  29     int rewindid(FILEID id);
  30
  31 SEE ALSO
  32     errno, fclose, feof, ferror, fflush, fgetc, fgetline, fgets, files, fopen,
  33     fprintf, fputc, fputs, fseek, fsize, ftell, isfile, printf, prompt
  34
  35 ## Copyright (C) 1999-2006  Landon Curt Noll
  36 ##
  37 ## Calc is open software; you can redistribute it and/or modify it under
  38 ## the terms of the version 2.1 of the GNU Lesser General Public License
  39 ## as published by the Free Software Foundation.
  40 ##
  41 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  42 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  43 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  44 ## Public License for more details.
  45 ##
  46 ## A copy of version 2.1 of the GNU Lesser General Public License is
  47 ## distributed with calc under the filename COPYING-LGPL.  You should have
  48 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  49 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  50 ##
  51 ## @(#) $Revision: 30.1 $
  52 ## @(#) $Id: rewind,v 30.1 2007/03/16 11:10:42 chongo Exp $
  53 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/rewind,v $
  54 ##
  55 ## Under source code control:   1996/04/30 03:05:18
  56 ## File existed as early as:    1996
  57 ##
  58 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  59 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/