Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

fsetpos()

Set the current position of a file

Synopsis:

#include <stdio.h>

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

Arguments:

fp
The stream whose position you want to set.
pos
A pointer to a fpos_t object that specifies the new position for the stream. You must have initialized the value pointed to by pos by calling fgetpos() on the same file.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fsetpos() function sets the current position of the stream specified by fp according to the value of the fpos_t object pointed to by pos.

Returns:

0 for success, or nonzero if an error occurs (errno is set).

Examples:

See fgetpos().

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

errno, fgetpos(), fopen(), fseek(), ftell()