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

Last reviewed: April 29, 1996
Article ID: Q100554
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, version 3.0
  • Microsoft FoxPro for Windows, versions 2.5, 2.5a
  • Microsoft FoxPro for MS-DOS, versions 2.0, 2.5, 2.5a

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.

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


Additional reference words: VFoxWin 3.00 FoxDos FoxWin 2.00 2.50 2.50a 2.x
command
system
hidden archive ADIR file
KBCategory: kbenv kbprg
KBSubcategory: FxenvMemory


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: April 29, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.