FSETPOS(3) NEWLIB FSETPOS(3)NAME
4.27 `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,
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 pre‐
vious 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'.
SEE ALSOfsetpos is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 FSETPOS(3)