GetDirectoryInfo()

Summary

Gets a listing of the contents of a directory.

 

Syntax

info = GetDirectoryInfo(string path, string type)

 

Argument	Contents
path	The full or partial path of the directory about which information is returned. Wildcards (? and *) may be used
type	The type of directory entries to list: "All", "Directory", "Folder", or "File"

 

Returns

An array containing one element for each file or directory of the indicated type in specified path. Each element is an array of eight items:

 

Element	Type	Contents
1	String	Filename, including extension, but not including the path
2	String	Type of file ("directory", "file", or "volume id")
3	String	Allowable access to the file ("read only", or "read/write")
4	String	State of the file ("hidden" or "not hidden")
5	String	System state of the file ("system" or "not system")
6	Real	Size of the file in bytes
7	String	Date of the file
8	String	Time of the file

 

Notes

• Directory and Folder mean the same thing.

• For more information on full and partial paths, see Identifying Files and Folders.

• GetDirectoryInfo() returns null if there are no directory entries of the indicated type in the path.

• If the type of directory entries to list is "Directory" then wildcards (? and *) must be used to have the list of directories returned.

• The size of the file is returned as a real number to handle very large files, and may not give the exact size.

Examples

// Get file information

di = GetDirectoryInfo("c:\\geofiles\\*.CDF", "File")

 

// Assemble a list of names and sizes

dim file_names[di.length]

total_size = 0

 

for i = 1 to di.length do

     file_names[i] = di[i][1]

     total_size = total_size + di[i][6]

     end

 

 

// Get directory information

di = GetDirectoryInfo("c:\\geofiles\\*", "Directory")

 

 

// Choose a folder and get information on its subfolders

in_path = ChooseDirectory("Choose a folder", )

dirs = GetDirectoryInfo(in_path+"\\*.*", "Folder")

 

Error Codes

Error Type	Meaning
Error	The type is invalid or an error occurred while reading the file information

 

See Also

Function	Summary
ChooseDirectory()	Gets the path name to an existing directory/folder
ChooseFolder()	Gets the path name to an existing directory/folder
FileCheckUsage()	Checks whether files are in use by Maptitude.
GetFileInfo()	Gets information about a file
GetDrives()	Returns a list of disk drives and their type
SearchFilePath()	Searches for the path for a filename
SetFileAttributes()	Changes the attributes of a file or a directory