DIRECTORY() 
 Crea una matriz de información de directorios y de ficheros
------------------------------------------------------------------------------
 Sintaxis

     DIRECTORY(<cEspecDir>, [<cAtributos>]) --> aDirectorio

 Argumentos

     <cEspecDir> identifica la unidad, el directorio y las
     especificaciones de fichero para la búsqueda en el directorio. Se
     permiten caracteres comodín en la especificación de fichero. Si se
     omite <cEspecDir>, el valor por defecto es *.*.

     <cAtributos> incluye en la información devuelta los ficheros que
     tengan los atributos especificados. <cAtributos> es una cadena, que
     contiene uno o más de los caracteres siguientes:

     Atributos DIRECTORY()
     ------------------------------------------------------------------------
     Atributo          Significado
     ------------------------------------------------------------------------
     H                 Incluir ficheros ocultos
     S                 Incluir ficheros del sistema
     D                 Incluir directorios
     V                 Buscar la etiqueta de volumen del DOS y excluir
                       el resto de los ficheros
     ------------------------------------------------------------------------

     Los ficheros normales siempre se incluyen en la búsqueda, a menos que
     especifique V.

 Devuelve

     DIRECTORY() devuelve una matriz de submatrices, cada una de las cuales
     contiene información de cada fichero que cumpla la <cEspecDir>. La
     submatriz tiene la estructura siguiente:

     Estructura de Submatriz DIRECTORY()
     ------------------------------------------------------------------------
     Posición      Metasímbolo    Directry.ch
     ------------------------------------------------------------------------
     1             cNombre        F_NAME
     2             cTamaño        F_SIZE
     3             dFecha         F_DATE
     4             cHora          F_TIME
     5             cAtributos     F_ATTR
     ------------------------------------------------------------------------

     Si no se encuentran ficheros que coincidan con <cEspecDir> o si
     <cEspecDir> es una vía de acceso o una especificación de fichero
     ilegal, DIRECTORY() devuelve una matriz vacía ({}).

 Descripción

     DIRECTORY() es una función de entorno que devuelve información sobre
     los ficheros en el directorio actual o en el directorio especificado.
     Es similar a ADIR(), pero devuelve una sola matriz en lugar de añadir
     valores a una serie de matrices existentes pasadas por referencia.

     Utilice DIRECTORY() para ejecutar acciones sobre grupos de ficheros. En
     combinación con AEVAL(), puede definir un bloque que puede aplicarse a
     todos los ficheros que cumplan la <cEspecDir> especificada.

     El fichero de cabecera, Directry.ch, situado en el subdirectorio
     \CLIP53\INCLUDE contiene #defines para los subíndices de submatriz, a
     fin de mejorar la legibilidad de las referencias a cada submatriz.

 Ejemplos

      Este ejemplo crea una matriz de información sobre los ficheros
        en el directorio actual y después lista los nombres de los ficheros
        utilizando AEVAL() y QOUT():

        #include "Directry.ch"
        //
        aDirectorio := DIRECTORY("*.*", "D")
        AEVAL( aDirectorio, {|aFichero| QOUT(aFichero[F_NAME])} )

 Ficheros   La biblioteca asociada es CLIPPER.LIB,
            el fichero de cabecera asociado es Directry.ch.
 To download this example - click here.

See Also: AEVAL() CURDIR()