Manpage of FSEEKO64

FSEEKO64

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents

NAME

4.4 `fseeko64'--set file position for large file

SYNOPSIS

     #include <stdio.h>
     int fseeko64(FILE *FP, _off64_t OFFSET, int WHENCE)
     int _fseeko64_r (struct _reent *PTR, FILE *FP,
         _off64_t OFFSET, int WHENCE)

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 `fseeko64' to set the position for the file identified by FP that was opened via `fopen64'. The value of OFFSET determines the new position, in one of three ways selected by the value of WHENCE (defined as macros in ``stdio.h''):

`SEEK_SET'--OFFSET is the absolute file position (an offset from the beginning of the file) desired. OFFSET must be positive.

`SEEK_CUR'--OFFSET is relative to the current file position. OFFSET can meaningfully be either positive or negative.

`SEEK_END'--OFFSET is relative to the current end of file. OFFSET can meaningfully be either positive (to increase the size of the file) or negative.

See `ftello64' to determine the current file position.

RETURNS

`fseeko64' returns `0' when successful. On failure, the result is `EOF'. The reason for failure is indicated in `errno': either `ESPIPE' (the stream identified by FP doesn't support repositioning or wasn't opened via `fopen64') or `EINVAL' (invalid file position).

PORTABILITY

`fseeko64' is a glibc extension.

Supporting OS subroutines required: `close', `fstat64', `isatty', `lseek64', `read', `sbrk', `write'.

This document was created by man2html, using the manual pages.
Time: 21:25:17 GMT, May 16, 2005