tf_seek(), sf_seek()

Purpose

Moves the file pointer

Old names

#define _vfseek tf_seek
#define _afseek sf_seek

Syntax (CCOWN)

file_pointer tf_seek(int file_handle, file_pointer posn)
file_pointer sf_seek(int file_handle, file_pointer posn)

Syntax (DP4DBAPI)

dp4_file_pointer dp4_sf_seek(FCONN * fconn, dp4_file_pointer posn);
dp5_file_pointer dp4_sf64_seek(FCONN * fconn, dp5_file_pointer posn);

Parameters

int file_handle

File handle of file, obtained by a call to tf_open() or sf_open()

 

FCONN * fconn

File handle of file, obtained by a call to dp4_sf_open()

 

file_pointer posn

New position of file pointer

Description

The tf_seek() and sf_seek() functions move the current position of the file pointer to be used for reading or writing the file.

The sf_seek() function calls the file-handling support in the database manager, and the tf_seek() function calls the file-handling support in the terminal manager. You must not call an sf_ function with a handle obtained with tf_open(), or a tf_ function with a handle obtained with sf_open().

The new position is from the beginning of the file. There is no support for moving the position as an offset from the current position or end of file, though you can use the get_position() functions to discover your current position.

See also

sf_get_position()