$FUNCNAME$
  ADIR()
$CATEGORY$
  FILE/IO,DISKUTILS
$SUMMARY$
   Fill a series of arrays with directory information
$LANG_RU$
       .
$SYNTAX$
     ADIR([<cFilespec>],[<aFilenames>],[<aSizes>],[<aDates>],
	[<aTimes>],[<aAttributes>]) --> nFiles
$LANG_RU$
     ADIR( [<  >], [<  >], [<  >],
	 [< >], [< >], [< >] ) -->  
$ARGUMENTS$
     <cFilespec> is the path specification of files to include in the
     scan of the DEFAULT directory.  It is a standard file specification that
     can include the wildcard characters * and ?, as well as a drive and path
     reference.  If omitted, the default specification is *.*.

     <aFilenames> is the array to fill with the file names matching
     <cFilespec>.  Each element contains the file name and extension as a
     character string in all uppercase letters.

     <aSizes> is the array to fill with the sizes of the corresponding
     files in the <aFilenames> array.  Each element is a numeric data type.

     <aDates> is the array to fill with the dates of the corresponding
     files in the <aFilenames> array.  Each element is a date data type.

     <aTimes> is the array to fill with the times of the corresponding
     files in the <aFilenames> array.  Each element filled contains a
     character string of the form: hh:mm:ss.

     <aAttributes> is the array to fill with attributes of the
     corresponding files in the <aFilenames> array.  Each element is a
     character string.  If <aAttributes> is specified, hidden, system, and
     directory files are included as well as normal files.  If <aAttributes>
     is not specified, only normal files are included.
$LANG_RU$
     <  > - ,     
      ,   DEFAULT.   
     ,       (*)  (?),  , 
           .    , 
        *.* .

     <  > - ,   ,
       <  >.   
                .

     <  > - ,    
        <  >.  
       .

     < > - ,    
       <  >.     DATE.

     < > - ,     
        <  >.  
             ::.

     < > - ,     
     <  >.    -   . 
      < > ,     
        ,    ,    
     .   < >  , 
         .
$RETURNS$
     ADIR() returns the number of files matching the directory skeleton
     described in <cFilespec>.
$LANG_RU$
     ADIR()   ,    
      .
$DESCRIPTION$
     ADIR() is an array function that performs two basic operations.  First,
     it returns the number of files matching the file specification.  Second,
     it fills a series of arrays with file names, sizes, dates, times, and
     attributes.

     ADIR() is a compatibility function and therefore not recommended.  It is
     superseded by the DIRECTORY() function which returns all file
     information in a multidimensional array.
$LANG_RU$
     ADIR() -    ,   
     . -,    , 
         . -,  
          ,  ,  
         .

     ADIR() -  ,     
      xClipper        
     .     DIRECTORY(), 
            .
$EXAMPLES$
       This example creates an array to hold the names of all .txt
	files in the current DEFAULT directory, then uses AEVAL() to list
	them to the console:

	LOCAL aFiles[ADIR("*.TXT")]
	ADIR("*.TXT", aFiles)
	AEVAL(aFiles, { |element| QOUT(element) })
$LANG_RU$
               
        (.txt)        
           AEVAL():

       LOCAL aFiles[ADIR("*.txt")]
       ADIR("*.txt", aFiles)
       AEVAL(aFiles, {|element| QOUT(element) })
$SEEALSO$
  ACHOICE(),AEVAL(),ASCAN(),ASORT(),DIRECTORY(),
$END$
