INFO: Using ADIR() Function to Obtain MS-DOS File Information (100554)



The information in this article applies to:

  • Microsoft Visual FoxPro for Windows 3.0
  • Microsoft Visual FoxPro for Windows 5.0
  • Microsoft Visual FoxPro for Windows 6.0
  • Microsoft FoxPro for Windows 2.5
  • Microsoft FoxPro for Windows 2.5a
  • Microsoft FoxPro for MS-DOS 2.0
  • Microsoft FoxPro for MS-DOS 2.5
  • Microsoft FoxPro for MS-DOS 2.5a

This article was previously published under Q100554

SUMMARY

The ADIR() function can be used to return MS-DOS file information, such as a file's date, time, size, and attributes.

MORE INFORMATION

ADIR() places information about all files in the current directory, or all files that match a file skeleton (such as "*.DBF") into an array, then returns the number of matching files. For each file found, ADIR() places the name, size, date, time, and MS-DOS attributes in the specified array.

If the directory is empty or there are no matches for the file skeleton, ADIR() does not create the array.

The following sample code demonstrates the use of the ADIR() function to obtain file information for C:\COMMAND.COM:

   =ADIR(FileInfo, "C:\COMMAND.COM")
   DISPLAY MEMORY LIKE FileInfo
				


The DISPLAY MEMORY LIKE FileInfo command shows information similar to the following:

   FILEINFO         Pub      A
				

( 1, 1) C "COMMAND.COM" ( 1, 2) N 52925 (52925.00000000) ( 1, 3) D 03/10/93 ( 1, 4) C " 6:00:00" ( 1, 5) C "R...."



According to these results, COMMAND.COM is 52,925 bytes in size, its date is 3/10/93, its time is 6 A.M., and the Read-Only attribute is set.

NOTE: ADIR() can also be used to return a drive's volume name.

(c) Microsoft Corporation 2000, All Rights Reserved. Contributions by Kevin Zollman, Microsoft Corporation.

REFERENCES

"Language Reference," version 2.5, page L3-176

Online Help, FoxPro 2.5 and 2.5a for Windows

Online Help, FoxPro 2.0, 2.5, and 2.5a for MS-DOS

Modification Type:MinorLast Reviewed:2/22/2005
Keywords:kbenv kbinfo KB100554