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 una

        <cEspecFichero> *.*, 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.