Creating New Files and Directories
A new file can be created using FSFile_Open() or fs_fopen(), if opened in write or append mode. There are a few other ways that new files can be created (most of which also apply to new directories).
The simplest is the FSEntry_Create() function, which just makes a new file or directory:
|
FSEntry_Create(“\\file.txt”, <-- file name FS_ENTRY_TYPE_FILE, <-- means entry will be a file DEF_NO, <-- DEF_NO means creation NOT exclusive &err); <-- return error |
If the second argument, entry_type, is FS_ENTRY_TYPE_DIR the new entry will be a directory. The third argument, excl, indicates whether the creation should be exclusive. If it is exclusive (excl is DEF_YES), nothing will happen if the file already exists. Otherwise, the file currently specified by the file name will be deleted and a new empty file with that name created.
Similar functions exist to copy and rename an entry:
|
FSEntry_Copy(“\\dir\\src.txt”, <-- source file name “\\dir\\dest.txt », <-- destination file name DEF_NO, <-- DEF_NO means creation not exclusive &err); <-- return error FSEntry_Rename (“\\dir\\oldname.txt”, <-- old file name “\\dir\\newname.txt”, <-- new file name DEF_NO, <-- DEF_NO means creation not exclusive &err); <-- return error |
FSEntry_Copy() can only be used to copy files. The first two arguments of each of these are both full paths; the second path is not relative to the parent directory of the first. As with FSEntry_Create(), the third argument of each, excl, indicates whether the creation should be exclusive. If it is exclusive (excl is DEF_YES), nothing will happen if the destination or new file already exists.