wiki.icculus.org
[ front page | index | search | recent changes | git repo | offline html ]

PHYSFS_setWriteDir

Tell PhysicsFS where it may write files.

Header File

Defined in <physfs.h>

Syntax

int PHYSFS_setWriteDir(const char *newDir);

Function Parameters

const char * newDir The new directory to be the root of the write dir, specified in platform-dependent notation. May be NULL.

Return Value

(int) Returns non-zero on success, zero on failure. Use PHYSFS_getLastErrorCode() to obtain the specific error.

Remarks

Set a new write dir. This will override the previous setting.

All attempts to open a file for writing via PhysicsFS will fail until there is a valid write dir specified through this function.

This call will fail (and fail to change the write dir) if the current write dir still has files open in it.

Passing a NULL here disables the write dir, so no files can be opened for writing via PhysicsFS, until a later call specifies a new write dir.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since PhysicsFS 1.0.0.

See Also


CategoryAPI, CategoryAPIFunction, CategoryPhysicsFS


[ edit | delete | history | feedback | raw ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.