[ First ]  [ Previous ]  [ Next ]  [ Last ]  [ Manuals ]


fsetpos

Set the file position indicator.

Compatibility:

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32


Prototype:
#include <stdio.h>
int fsetpos(FILE *stream, const fpos_t *pos);
Parameters:

Parameters for this facility are:

stream  
FILE *  
A pointer to a FILE stream  
pos  
fpos_t  
A pointer to a file positioning type  

Remarks:

The fsetpos() function sets the file position indicator for stream using the value pointed to by pos. The function is used in conjunction with fgetpos() when dealing with files having sizes greater than what can be represented by the long int argument used by fseek().

fsetpos() undoes the previous call to ungetc() and clears the end-of-file status.


NOTE

On embedded/ RTOS systems this function only is implemented for stdin, stdout and stderr files.
Return:

fsetpos() returns zero if it is successful and returns a nonzero value if it fails.

See Also:

"fgetpos"

"fseek"

"ftell"

For example of fsetpos() usage:
Refer to "Example of fgetpos() usage." for fgetpos().


[ First ]  [ Previous ]  [ Next ]  [ Last ]  [ Manuals ]

Visit the Metrowerks website at: http://www.metrowerks.com
For assistance contact Metrowerks Technical Support at: cw_support@metrowerks.com
Copyright © 2000, Metrowerks Corp. All rights reserved.

Last updated: August 16, 2000