Close a PhysicsFS filehandle.
Defined in <physfs.h>
int PHYSFS_close(PHYSFS_File *handle);| PHYSFS_File * | handle | handle returned from PHYSFS_open*(). |
(int) Returns nonzero on success, zero on error. Use PHYSFS_getLastErrorCode() to obtain the specific error.
This call is capable of failing if the operating system was buffering writes to the physical media, and, now forced to write those changes to physical media, can not store the data for some reason. In such a case, the filehandle stays open. A well-written program should ALWAYS check the return value from the close call in addition to every writing call!
Multiple threads can not operate on the same PHYSFS_File at the same time, but they can safely operate on different ones simultaneously.
This function is available since PhysicsFS 1.0.0.