f78
fsetpos
[restore position of a stream or file]
SYNOPSIS
#include
<stdio.h>
int fsetpos(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 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
6bc
repositioning) or EINVAL
(invalid file position).
COMPLIANCE
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.
0