fsetpos(3C) (C Programming Language Utilities) fsetpos(3C)
NAME
fsetpos, fgetpos - reposition a file pointer in a stream
SYNOPSIS
#include <stdio.h>
int fsetpos (FILE *stream, const fpost *pos);
int fgetpos (FILE *stream, fpost *pos);
DESCRIPTION
fsetpos sets the position of the next input or output operation on
the stream according to the value of the object pointed to by pos.
The object pointed to by pos must be a value returned by an earlier
call to fgetpos on the same stream.
fsetpos clears the end-of-file indicator for the stream and undoes
any effects of the ungetc function on the same stream. After fsetpos,
the next operation on a file opened for update may be either input or
output.
fgetpos stores the current value of the file position indicator for
stream in the object pointed to by pos. The value stored contains
information usable by fsetpos for repositioning the stream to its
position at the time of the call to fgetpos.
If successful, both fsetpos and fgetpos return zero. Otherwise, they
both return nonzero.
SEE ALSO
fseek(3S), lseek(2) ungetc(3S).
7/91 Page 1