fsetpos(3C) — DG/UX R4.11MU05



fsetpos(3C)                    DG/UX R4.11MU05                   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.

   Return Values
       If successful, both fsetpos and fgetpos return zero.  Otherwise, they
       both return nonzero.

   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |             point     safe  |
                     +---------+-----------------------------+
                     |fsetpos  |     Y         N        N    |
                     |fgetpos  |     Y         N        N    |
                     +---------+-----------------------------+
REFERENCES
       lseek(2), reentrant(3), fseek(3S), ungetc(3S)


Licensed material--property of copyright holder(s)
Museum
