1
0

APIDump: Documented the new cFile API functions.

This commit is contained in:
madmaxoft 2013-10-09 11:31:38 +02:00
parent 27ce6dd97e
commit 9fc35514e6
2 changed files with 26 additions and 2 deletions

View File

@ -841,6 +841,30 @@ World:ForEachChestInChunk(Player:GetChunkX(), Player:GetChunkZ(),
}, },
}, },
cFile =
{
Desc = [[
Provides helper functions for manipulating and querying the filesystem. Most functions are called
directly on the cFile class itself:
<pre>
cFile:Delete("/usr/bin/virus.exe");
</pre></p>
]],
Functions =
{
Copy = { Params = "SrcFileName, DstFileName", Return = "bool", Notes = "Copies a single file to a new destination. Returns true if successful. Fails if the destination already exists." },
CreateFolder = { Params = "FolderName", Return = "bool", Notes = "Creates a new folder. Returns true if successful." },
Delete = { Params = "FileName", Return = "bool", Notes = "Deletes the specified file. Returns true if successful." },
Exists = { Params = "FileName", Return = "bool", Notes = "Returns true if the specified file exists." },
GetSize = { Params = "FileName", Return = "number", Notes = "Returns the size of the file, or -1 on failure." },
IsFile = { Params = "Path", Return = "bool", Notes = "Returns true if the specified path points to an existing file." },
IsFolder = { Params = "Path", Return = "bool", Notes = "Returns true if the specified path points to an existing folder." },
Rename = { Params = "OrigPath, NewPath", Return = "bool", Notes = "Renames a file or a folder. Returns true if successful. Undefined result if NewPath already exists." },
},
},
cFireChargeEntity = cFireChargeEntity =
{ {
Desc = "", Desc = "",

View File

@ -103,8 +103,8 @@ public:
/// Deletes a file, returns true if successful /// Deletes a file, returns true if successful
static bool Delete(const AString & a_FileName); static bool Delete(const AString & a_FileName);
/// Renames a file, returns true if successful. May fail if dest already exists (libc-dependant)! /// Renames a file or folder, returns true if successful. May fail if dest already exists (libc-dependant)!
static bool Rename(const AString & a_OrigFileName, const AString & a_NewFileName); static bool Rename(const AString & a_OrigPath, const AString & a_NewPath);
/// Copies a file, returns true if successful. /// Copies a file, returns true if successful.
static bool Copy(const AString & a_SrcFileName, const AString & a_DstFileName); static bool Copy(const AString & a_SrcFileName, const AString & a_DstFileName);