Manpage of FSETPOS64
FSETPOS64
Section: NEWLIB (3)
Updated: 2005 Feb 23
Index
Return to Main Contents
NAME
4.6 `fsetpos64'--restore position of a large stream or file
SYNOPSIS
#include <stdio.h>
int fsetpos64(FILE *FP, const _fpos64_t *POS);
int _fsetpos64_r(struct _reent *PTR, FILE *FP,
const _fpos64_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 `fsetpos64' to return the large file identified by FP to
a previous position `*POS' (after first recording it with `fgetpos64').
See `fseeko64' for a similar facility.
RETURNS
`fgetpos64' returns `0' when successful. If `fgetpos64' fails, the
result is `1'. The reason for failure is indicated in `errno': either
`ESPIPE' (the stream identified by FP doesn't support 64-bit
repositioning) or `EINVAL' (invalid file position).
PORTABILITY
`fsetpos64' is a glibc extension.
Supporting OS subroutines required: `close', `fstat', `isatty',
`lseek64', `read', `sbrk', `write'.
SEE ALSO
fsetpos64
is part of the
libc
library.
The full documentation for
libc
is maintained as a Texinfo manual. If
info
and
libc
are properly installed at your site, the command
-
info libc
will give you access to the complete manual.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURNS
-
- PORTABILITY
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 21:25:17 GMT, May 16, 2005
www.fiveanddime.net