__DIR()*
Display listings of files
- Syntax
- __Dir( [<cFileMask>] ) --> NIL
- Arguments
- <cFileMask> File mask to include in the function return. It could contain path and standard wildcard characters as supported by your OS (like * and ?). If <cFileMask> contains no path, then SET DEFAULT path is used to display files in the mask.
- Returns
- __Dir() always returns NIL.
- Description
- If no is given, __Dir() displays information about all *.dbf in the SET DEFAULT path. This information contains: file name, number of records, last update date and the size of each file.
- If is given, __Dir() list all files that match the mask with the following details: Name, Extension, Size, Date.
- DIR command is preprocessed into __Dir() function during compile time.
- __Dir() is a compatibility function, it is superseded by DIRECTORY() which return all the information in a multidimensional array.
- Examples
- __Dir() // information for all DBF files in current directory
- __Dir( "*.dbf" ) // list all DBF file in current directory
- // list all PRG files in Harbour Run-Time library
- // for DOS compatible operating systems
- __Dir( "c:\harbour\source\rtl\*.prg" )
- // list all files in the public section on a Unix like machine
- __Dir( "/pub" )
- Status
Ready
- Compliance
- DBF information: CA-Clipper displays 8.3 file names, Harbour displays the first 15 characters of a long file name if available.
- File listing: To format file names displayed we use something like: PadR( Name, 8 ) + " " + PadR( Ext, 3 ) CA-Clipper use 8.3 file name, with Harbour it would probably cut long file names to feet this template.
- Files
- Library is rtl
- See Also