ADIR()* 
 Llena una serie de matrices con información del directorio
------------------------------------------------------------------------------
 Sintaxis

     ADIR([<cEspecFichero>],
        [<aNombresFichero>],
        [<aTamaños>],
        [<aFechas>],
        [<aHoras>],
        [<aAtributos>]) --> nFicheros

 Argumentos

     <cEspecFichero> es la especificación de la vía de los ficheros que
     se van a incluir en la búsqueda del directorio por defecto. Es una
     especificación de ficheros estándar, que permite incluir caracteres
     comodín * y ? y referencias de unidades y vías. Si se omite, la
     especificación por defecto es *.*.

     <aNombresFichero> es la matriz que se va a llenar con los nombres
     de ficheros seleccionados con <cEspecFichero>. Cada elemento contiene
     el nombre y la extensión del fichero en forma de cadena de caracteres
     en mayúsculas.

     <aTamaños> es la matriz que se va a llenar con los tamaños de los
     ficheros correspondientes de la matriz <aNombresFichero>. Todos sus
     elementos son de tipo numérico.

     <aFechas> es la matriz que se va a llenar con las fechas de los
     ficheros correspondientes de la matriz <aNombresFichero>. Todos sus
     elementos son de tipo fecha.

     <aHoras> es la matriz que se va a llenar con las horas de los
     ficheros correspondientes de la matriz <aNombresFichero>. Todos sus
     elementos contienen una cadena de caracteres de formato: hh:mm:ss.

     <aAtributos> es la matriz que se va a rellenar con atributos de los
     ficheros correspondientes de la matriz <aNombresFichero>. Todos los
     elementos son cadenas de caracteres. Si se especifica <aAtributos>,
     pueden incluirse ficheros ocultos, de sistema y de directorio junto a
     los ficheros normales. Si no se especifica <aAtributos>, solamente se
     incluyen ficheros normales.

 Devuelve

     ADIR() devuelve el número de ficheros seleccionables con el patrón de
     directorios descrito por <cEspecFichero>.

 Descripción

     ADIR() es una función de matrices que realiza dos operaciones básicas.
     En primer lugar, devuelve el número de ficheros seleccionables con la
     especificación de ficheros. En segundo lugar, llena una serie de
     matrices con los nombres, tamaños, fechas, horas y atributos de los
     ficheros.

     ADIR() es una función de compatibilidad y, por tanto, su utilización no
     es recomendable. Puede sustituirse por la función DIRECTORY(), que
     devuelve toda la información de ficheros en una matriz
     multidimensional.

 Notas

     ■ Directorios: Si se utiliza un argumento <aAtributos> y
        <cEspecFichero> es *.*, pueden incluirse directorios en
        <aNombresFichero>. En la matriz <aAtributos>, para indicar
        directorios se utiliza un atributo "D". Si se ejecuta ADIR() en un
        subdirectorio, las dos primeras entradas de <aNombresFichero> serán
        "." y "..", los alias de los directorios principal y actual
        respectivamente. Se indica también la fecha y hora de la última
        actualización de un directorio, pero su tamaño es siempre cero.

 Ejemplos

      El ejemplo siguiente crea una matriz que va a contener los
        nombres de todos los ficheros (.txt) del directorio por defecto
        actual y, a continuación, utiliza AEVAL() para listarlos en la
        consola:

        LOCAL aFicheros[ADIR("*.TXT")]
        ADIR("*.TXT", aFicheros)
        AEVAL(aFicheros, { |elemento| QOUT(elemento) })

 Ficheros   La biblioteca asociada es EXTEND.LIB.

 To download this example - click here.

See Also: ACHOICE() AEVAL() ASCAN() ASORT() DIRECTORY()