Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

fseeko64(3) Guardian Native C Library Calls Reference Manual
NAME
fseeko64 - Repositions the file pointer of a stream
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <stdio.h>
int fseeko64(
FILE ∗∗stream,
off64_t offset,
int whence);
PARAMETERS
stream Specifies the I/O stream.
offset Determines the position of the next operation.
whence Determines the value for the file pointer associated with the stream parameter.
DESCRIPTION
The fseeko64() function is identical to the fseek() function except that its return value is of type
off64_t.
An application can explicitly call this function you compile the application using the #define
_LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command option.
An application call to fseek() or to fseeko() is automatically mapped to this function when you
compile the application using the #define _FILE_OFFSET_BITS 64 feature test macro or an
equivalent compiler command option.
The fseeko64() function sets the position of the next input or output operation on the I/O stream
specified by the stream parameter. The offset parameter, which can be either positive or negative,
determines the position of the next operation.
The fseeko64() function sets the file pointer associated with the specified stream as follows:
• If the whence parameter is SEEK_SET, the pointer is set to the value of the offset
parameter.
• If the whence parameter is SEEK_CUR, the pointer is set to its current location plus the
value of the offset parameter.
• If the whence parameter is SEEK_END, the pointer is set to the size of the file plus the
value of the offset parameter.
The fseeko64() function fails if attempted on a file that was not opened with the fopen() func-
tion. In particular, you cannot use the fseeko() function on a terminal or on a file opened with
the popen( ) function.
A successful call to the fseeko64() function clears the End-of-File indicator for the stream and
undoes any effects of the ungetc() function on the same stream. After a call to the fseeko64()
function, the next operation on an update stream can be either input or output.
If the stream is writable, and buffered data was not written to the underlying file, the fseeko64()
function causes the unwritten data to be written to the file and marks the st_ctime and st_mtime
2−142 Hewlett-Packard Company 527192-018