SL_SeekFile


NAME
SL_SeekFile -- Set the current position for reading and writing.

SYNOPSIS
success = SL_SeekFile(filehandle, offset, mode)
D0 A0 D2 D3

SLFLAG SL_SeekFile(SLFHANDLE, LONG, LONG);

FUNCTION
Sets the current position for reading and writing data to/from a
file. You cannot seek past the end of a file.

The offset used for FSEEK_BEGINNING must be positive. The offset used
for FSEEK_END must be negative.

This call does not invalidate the i/o buffer if the seek is within the
buffer. If the seeks falls outside the current buffer then the next
read will cause a full buffer reload.

INPUTS
filehandle
offest - how many bytes to move relative to the mode.
mode - one of: FSEEK_BEGINNING, FSEEK_CURRENT, FSEEK_END.
this sets the relativity of the offset.

RESULTS
success - TRUE if the seek succeded.
FALSE if the call failed.

NOTE
On the Amiga only small forward relative seeks will not invalidate the
buffer, all others will.

SEE ALSO
SL_BeginExamine, SL_CloseFile, SL_DeleteFile, SL_DoesFileExist, SL_EndExamine, SL_EndFileNotify, SL_ExamineFirstFile, SL_ExamineNextFile, SL_FileRequesterA, SL_FlushFile, SL_GetExFileInfo, SL_GetExFileInfoFH, SL_GetFileName, SL_GetFileNotifyAttrA, SL_GetFilePath, SL_GetFilePos, SL_GetFileSize, SL_GetFileSizeFH, SL_LockFile, SL_MakePath, SL_OpenClipboard, SL_OpenFile, SL_ReadFile, SL_RenameFile, SL_SeekFile, SL_SetFileNotifyAttrA, SL_UnlockFile, SL_WriteFile.

 

SL_SeekFile  Command Section By Type  url:SL_SeekFile
  created:2008-03-01 23:36:17   last updated:2008-03-01 23:36:17
  Copyright © 1985-2017 GrasshopperLLC. All Rights Reserved.

User Contributed Comments For SL_SeekFile
There are no user contributed comments for this page.