compiler/clib/fgetpos.c

   1 /*
   2     Copyright © 1995-2012, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Get the position in a stream.
   6 */
   7
   8 #include <errno.h>
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <stdio.h>
  14
  15         int fgetpos (
  16
  17 /*  SYNOPSIS */
  18         FILE   * stream,
  19         fpos_t * pos)
  20
  21 /*  FUNCTION
  22         Get the current position in a stream. This function is eqivalent
  23         to ftell(). However, on some systems fpos_t may be a complex
  24         structure, so this routine may be the only way to portably
  25         get the position of a stream.
  26
  27     INPUTS
  28         stream - The stream to get the position from.
  29         pos - Pointer to the fpos_t position structure to fill.
  30
  31     RESULT
  32         0 on success and -1 on error. If an error occurred, the global
  33         variable errno is set.
  34
  35     NOTES
  36
  37     EXAMPLE
  38
  39     BUGS
  40
  41     SEE ALSO
  42         fsetpos()
  43
  44     INTERNALS
  45
  46 ******************************************************************************/
  47 {
  48     if ( pos == NULL )
  49     {
  50         errno = EINVAL;
  51         return -1;
  52     }
  53
  54     *pos = ftell (stream);
  55
  56     if ( *pos < 0L )
  57     {
  58         return -1;
  59     }
  60
  61     return 0;
  62 } /* fgetpos */
  63