BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kfseek - set position in a data transport stream
LIBRARY CALL
int kfseek(
kfile *file,
long int offset,
int whence)
INPUT
- file - the kfile pointer associated with the open stream
to the data transport, opened earlier with kfopen()
- offset - offset specifying new position of file pointer
- whence - controls how the offset will be applied:
0 - sets the pointer to the absolute
value of the offset parameter
1 - sets the pointer to its current location plus
the value of the offset parameter
2 - sets the pointer to the size of the file plus
the value of the offset parameter
OUTPUT
none
RETURN VALUE
0 on success, -1 on failure
DESCRIPTION
This function is a replacement for the system "fseek"
call; kfseek() supports all khoros data transport
mechanisms, not just Unix files.
This function sets the position of the next input or
output operation on the data transport stream by changing
the location of the data transport pointer.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/kstdio.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.