compiler/stdc/fsetpos.c

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