Bfile SeekFile OS

From WikiPrizm
Jump to: navigation, search


Synopsis

Header: fxcg/file.h
Syscall index: 0x1DA9
Function signature: int Bfile_SeekFile_OS(int handle, int pos)

Changes the position in the file handle, similar to fseek.

Parameters

  • handle: File handle as returned by Bfile_OpenFile_OS.
  • pos: Position (absolute, not relative) to seek to.

Returns

Returns the new position in the file handle.

Comments

This function seeks to an absolute location in the file pointer. To seek backwards, use Bfile_GetFileSize_OS and add the offset to that.

WARNING: This function resizes the file if pos > Bfile_GetFileSize_OS. The file cannot shrink, only expand. If you need to shrink a file, delete then recreate it, and write the new contents.

Using Bfile functions while user timers are installed can cause SYSTEM ERRORs and other undefined behavior, especially with functions that change data on the file system. Make sure to stop and uninstall all timers before using Bfile functions (and optionally restore them later). See Incompatibility between Bfile Syscalls and Timers for more information.