compiler/clib/fgetpos.c

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