Manpage of FSETPOS

FSETPOS

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents

NAME

3.18 `fsetpos'--restore position of a stream or file

SYNOPSIS

     #include <stdio.h>
     int fsetpos(FILE *FP, const fpos_t *POS);
     int _fsetpos_r(struct _reent *PTR, FILE *FP, l
         const fpos_t *POS);

DESCRIPTION

Objects of type `FILE' can have a "position" that records how much of the file your program has already read. Many of the `stdio' functions depend on this position, and many change it as a side effect.

You can use `fsetpos' to return the file identified by FP to a previous position `*POS' (after first recording it with `fgetpos').

See `fseek' for a similar facility.

RETURNS

`fgetpos' returns `0' when successful. If `fgetpos' fails, the result is `1'. The reason for failure is indicated in `errno': either `ESPIPE' (the stream identified by FP doesn't support repositioning) or `EINVAL' (invalid file position).

PORTABILITY

ANSI C requires `fsetpos', but does not specify the nature of `*POS' beyond identifying it as written by `fgetpos'.

Supporting OS subroutines required: `close', `fstat', `isatty', `lseek', `read', `sbrk', `write'.

This document was created by man2html, using the manual pages.
Time: 21:25:17 GMT, May 16, 2005