Skip to main content

get_dir

Discworld driver help

get_dir

Name

get_dir() - returns information pertaining to a filesystem directory

Synopsis

mixed *get_dir( string dir );
mixed *get_dir( string dir, int flag );

Description

If `dir' is a filename ('*' and '?' wildcards are supported), an array of strings is returned containing all filenames that match the specification. If `dir' is a directory name (ending with a slash — i.e.: "/u/", "/adm/", etc), all filenames in that directory are returned.

If called with `flag' equal to -1, get_dir will return an array of subarrays, where the format of each subarray is:

       ({ filename, size_of_file, last_time_file_touched })

Where filename is a string and last_time_file_touched is an integer being number of seconds since January 1, 1970 (same format as time()). The size_of_file element is the same value that is returned by file_size(); the size of the file in bytes, or -2 if it's a directory.

See also

file_size(), stat(), time(), ctime()