Synopsis #

Header: fxcg/file.h
Syscall index: 0x1DA6
Function signature: int Bfile_GetFileSize_OS(int handle)

Gets the file size of a open file, given its handle.

Parameters #

  • handle - the handle of the file one wants to know the size (this is the value returned by Bfile_OpenFile_OS)

Returns #

Returns the file size.

Comments #

If you are trying to get the file size of multiple files at once without having to open and close each, using the file search functions (Bfile_FindFirst and friends) may be easier and faster, because with these the file size is returned in the the file_type_t struct, and one only needs to open and close the find handle.

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.