c_cpp/etc/calc/help/ftell

   1 NAME
   2     ftell - return a file position
   3
   4 SYNOPSIS
   5     ftell(fd)
   6
   7 TYPES
   8     fd          open file stream
   9
  10     return      non-negative integer or error value
  11
  12 DESCRIPTION
  13     This function attempts to return the current value of the file position
  14     indicator for the stream.  This is the number of characters (bytes)
  15     between the beginning of the file and the position of the
  16     next character for output in "w" or "w+" mode or for input.
  17
  18      On failure, this returns an error value.
  19
  20 EXAMPLE
  21     ; fd = fopen("/tmp/curds", "w")
  22     ; fputs(fd, "0123456789")
  23     ; ftell(fd)
  24         10
  25     ; fputs(fd, "abcdef")
  26     ; ftell(fd)
  27         16
  28     ; fseek(fd, 20, 0)
  29     ; ftell(fd)
  30         20
  31     ; fputs(fd, "01234")
  32     ; ftell(fd)
  33         25
  34     ; freopen(fd, "r")
  35     ; fscanf(fd, "%*5c")
  36         0
  37     ; ftell(fd)
  38         5
  39
  40 LIMITS
  41     none
  42
  43 LINK LIBRARY
  44     none
  45
  46 SEE ALSO
  47     fseek, fgetpos, fsetpos, rewind, strerror
  48
  49 ## Copyright (C) 1999  Landon Curt Noll
  50 ##
  51 ## Calc is open software; you can redistribute it and/or modify it under
  52 ## the terms of the version 2.1 of the GNU Lesser General Public License
  53 ## as published by the Free Software Foundation.
  54 ##
  55 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  56 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  57 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  58 ## Public License for more details.
  59 ##
  60 ## A copy of version 2.1 of the GNU Lesser General Public License is
  61 ## distributed with calc under the filename COPYING-LGPL.  You should have
  62 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  63 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  64 ##
  65 ## @(#) $Revision: 30.1 $
  66 ## @(#) $Id: ftell,v 30.1 2007/03/16 11:10:42 chongo Exp $
  67 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/ftell,v $
  68 ##
  69 ## Under source code control:   1995/03/04 11:33:21
  70 ## File existed as early as:    1995
  71 ##
  72 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  73 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/