void|array(string) find_dir(string path, object id)

The find_dir() gives a directory listing; an array of strings containing the names of all files and directories in this directory. path is the path to the directory, in the modules name space. id is the request information object.

This method is usually called because a previous call to find_file() returned that this path contained a directory and a directory type module is right now trying to create a directory listing of this directory. Note that it is possible that the find_dir() is called in several location modules, and that the actual directory listing shown to the user will be the concatenated result of all those calls.

To find information about each entry in the returned array the stat_file() will probably be used.