[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    fsetpos(3C) manual page Table of Contents

Name

fsetpos, fgetpos - reposition a file pointer in a stream

Synopsis

#include <stdio.h>

int fsetpos(FILE *stream, const fpos_t *pos);

int fgetpos(FILE *stream, fpos_t *pos);

MT-Level

MT-Safe

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().

Return Values

If successful, both fsetpos() and fgetpos() return zero. Otherwise, they both return nonzero.

See Also

lseek(2) , fseek(3S) , ungetc(3S)


Table of Contents