Contents|Index|Previous|Next

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