compiler/clib/fsetpos.c

   1 /*
   2     Copyright © 1995-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Change the position in a stream.
   6 */
   7
   8 #include <errno.h>
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <stdio.h>
  14
  15         int fsetpos (
  16
  17 /*  SYNOPSIS */
  18         FILE            * stream,
  19         const fpos_t    * pos)
  20
  21 /*  FUNCTION
  22         Change the current position in a stream. This function is eqivalent
  23         to fseek() with whence set to SEEK_SET. However, on some systems
  24         fpos_t may be a complex structure, so this routine may be the only
  25         way to portably reposition a stream.
  26
  27     INPUTS
  28         stream - Modify this stream
  29         pos - The new position in the stream.
  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         fgetpos()
  43
  44     INTERNALS
  45
  46 ******************************************************************************/
  47 {
  48     int retval;
  49
  50     if ( pos == NULL )
  51     {
  52         errno = EINVAL;
  53         return -1;
  54     }
  55
  56     retval = fseek (stream, *pos, SEEK_SET);
  57
  58     return retval;
  59 } /* fsetpos */
  60