Filesystem Module
Contents
getFileName
string filesystem.getFileName(string path)
Returns just the filename (no path) section of a full path.
getFilePath
string filesystem.getFilePath(string path)
Returns just the path (no filename) section of a full path. Does not include trailing slash (/).
directoryExists
boolean filesystem.directoryExists(string path)
If the given directory exists, returns true. Else, returns false.
fileExists
boolean filesystem.fileExists(string path)
If the given file exists, returns true. Else, returns false.
getDirectory
table filesystem.getDirectory(string path)
If the given directory does not exist or contains no files, this function fails. Otherwise, returns a table of filenames & directories contained in this path. This does not include "." and ".."
isDirectory
boolean filesystem.isDirectory(string path)
If the given path is a directory, returns true. Else, returns false.
createDirectory
boolean filesystem.createDirectory(string path)
Creates a directory at 'path'. This function is recursive and will create additional directories as necessary. Returns true on success, else false.
fixSlashes
string filesystem.fixSlashes(string path[, boolean posix])
Convert slashes within 'path' to / (POSIX standard) or \ (Windows only).
If posix is true (default), converts backslashes(\) to forward slashes(/). Else, converts forward slashes to backslashes.
getOpenFileName
string filesystem.getOpenFileName(string defaultFilename[, string filter])
Displays the standard open file dialog. 'defaultfilename' can contain a full path to the default file. 'filter' should be properly formatted: Split key/value pairs with NULL (\0), terminate with double NULL(\0\0). Multiple filetypes should be split with semicolon (;). For example:
filter = "All Files\0*.*\0Lua files\0*.lua\0Image files\0*.bmp;*.jpg\0\0";
filesystem.getOpenFileName("", filter);
If the user cancels the dialog, this function fails and returns nil.
getSaveFileName
string filesystem.getSaveFileName(string defaultFilename[, string filter])
This works exactly like filesystem.getOpenFileName() except that it shows the dialog for saving a file.
getCWD
string filesystem.getCWD()
Returns the current working directory. This should be the directory that MicroMacro is currently executing a script from.
setCWD
filesystem.getCWD()
Modify the current working directory (CWD) to the given path. You probably don't want to do this under normal conditions.