Definition:

#include <aIO.h>
object code: aIO shared library



aLIBRETURN aFile_Seek(

aIOLib ioRef, aFileRef fileRef, const long nOffset, aBool bFromStart, aErr* pErr);

Parameters:

ioRef	-	A pointer to the opaque library reference used when seeking in the file.
fileRef	-	A aFileRef reference that represents the file for seeking.
nOffset	-	The amount to seek either forward (positive) or backward (negative) in the file.
bFromStart	-	If true, the seek is from the beginning of the file and if not, the seek is from the current position in the file.
pErr	-	A pointer to an aErr variable that receives the error code on exit from this routine.

Return Value:

This library routine returns an aLIBRETURN type that is non-zero if there are errors, and zero if the routine completes with no errors.

Description:

This repositions the current file pointer to a new position.  Subsequent aFile_Read or aFile_Write calls will be from this new position after a successful seek.  Seeking beyond the end of a file or in front of the beginning results in an aErrMode error.

Related:

aFile_Open, aFile_Close, aFile_Read, aFile_Write, aFile_GetSize, aFile_Delete