utils.readdir

t = utils.readdir (s)

You can use utils.readdir to read an entire directory on your PC into a Lua table, based on the wildcard you supply.


For example:

t, e = utils.readdir ("c:/mushclient/plugins/*.xml")

assert (t, e) -- raises error on failure

If the directory specification is matched, the result from the call is a table of directory items, keyed by the filename. If the directory specification cannot be matched, or is invalid, it returns nil followed by an error message. You can simply test for non-nil, or call "assert" to report the error.

For each file in the directory (that matches the wildcard) the following is returned:

• size - file size in bytes
• create_time - creation time (except for FAT filesystems, where it is omitted)
• access_time - last access time (except for FAT filesystems, where it is omitted)
• write_time - time written
• archive - true if archive. Set whenever the file is changed, and cleared by the BACKUP command.
• hidden - hidden file. Not normally seen with the DIR command
• normal - normal file. File can be read or written to without restriction.
• readonly - read-only. File cannot be opened for writing, and a file with the same name cannot be created.
• directory - Subdirectory.
• system - system file. Not normally seen with the DIR command.

By detecting suddirectories you could conceivably recurse and find the contents of subdirectories as well.