Click above to get retro games delivered to your door ever month!

 twDirectory( cSpec, cAttributes )
 ----------------------------------------------------------------------------
     Replacement for Clipper DIRECTORY(). twDirectory() guarantees file
     names will be expanded to the full DOS length of 13 characters.
     This function makes it easy to arrange files in a browse.

       Arguments:

     cSpec        - 'C' Specifies the drive, directory and file
                        specification for the directory search.
                        Wildcards are allowed in the file
                        specification.  The default value is *.*.

     cAttributes  - 'C' Specifies that files with special attributes
                        are to be included in the returned information.
                        cAttributes consists of a string containing one
                        or more of the following characters:

                        twDirectory() Attributes
                        ---------------------------------------------------
                        Attr   Meaning
                        ---------------------------------------------------
                        H      Include hidden files
                        S      Include system files
                        D      Include directories
                        V      Search for the DOS volume label and exclude
                               all other files
                        ---------------------------------------------------

                        Normal files are always included in the search,
                        unless V is specified.

       Return: twDirectory() returns an array of subarrays, with
                   each subarray containing information about each file
                   matching cSpec.  The subarray has the following
                   structure:

                   Table 5-13: DIRECTORY() Subarray Structure
                   -----------------------------------
                   No.   Metasymbol       Directry.ch
                   -----------------------------------
                   1    cName            F_NAME
                   2    cSize            F_SIZE
                   3    dDate            F_DATE
                   4    cTime            F_TIME
                   5    cAttributes      F_ATTR
                   -----------------------------------

                   If no files are found matching cSpec or cSpec is an
                   illegal path or file specification, DIRECTORY()
                   returns an empty ({}) array.

       Example:

     aDirectory := twDirectory( "*.*" )