ADIR()*
 Preenche uma série de vetores com informaçoes de diretório
------------------------------------------------------------------------------

 Sintaxe

     ADIR([<cEspecArq>],
        [<aNomesArq>],
        [<aTamanhos>],
        [<aDatas>],
        [<aHoras>],
        [<aAtributos>]) --> nArquivos

 Argumentos

     <cEspecArq> é a especificaçao dos arquivos a serem incluidos na
     pesquisa do diretório padrao.  É uma especificaçao de arquivo padrao
     que pode incluir os caracteres coringa do tipo * e ?, bem como
     referência a diretório e path.  Caso nao seja especificado, o padrao
     assumido é *.*.

     <aNomesArq> é o vetor a ser preenchido com os nomes de arquivo que
     correspondem a <cEspecArq>.  Cada elemento contém o nome do arquivo e
     extensao na forma de uma cadeia de caracteres em letras maiúsculas.

     <aTamanhos> é o vetor a ser preenchido com os tamanhos dos arquivos
     correspondentes no vetor <aNomesArq>.  Cada elemento é numérico.

     <aDatas> é o vetor a ser preenchido com as datas dos arquivos
     correspondentes no vetor <aNomesArq>.  Cada elemento é uma data.

     <aHoras> é o vetor a ser preenchido com as horas dos arquivos
     correspondentes no vetor <aNomesArq>.  Cada elemento preenchido contém
     uma cadeia de caracteres da forma: hh:mm:ss.

     <aAtributos> é o vetor a ser preenchido com os atributos dos
     arquivos correspondentes no vetor <aFilenames>.   Cada elemento é uma
     cadeia de caracteres.  Caso <aAtributos> seja especificado, os arquivos
     de diretório, sistema, e escondidos sao incluidos, assim como os
     arquivos normais.  Se <aAtributos> nao for especificado, somente os
     arquivos normais sao incluidos.

 Retorno

     ADIR() retorna a quantidade de arquivos que correspondem ao esqueleto
     de diretório especificado.

 Descriçao

     ADIR() é uma funçao de tratamento de vetor que executa duas operaçoes
     básicas.  Primeiro, ele retorna a quantidade de arquivos que
     correspondem à especificaçao de arquivo.  Segundo, preenche uma série
     de vetores com nomes de arquivos, tamanhos, datas, horas e atributos.

     ADIR() é uma funçao de compatibilidade e portanto desaconselhada.  Ele
     está superado pela funçao DIRECTORY(), que retorna todas as informaçoes
     de arquivo em um vetor multi-dimensional.

 Notas

       Diretórios: Caso o argumento <aAtributos> seja
        especificado e <cEspecArq> seja especificado como *.*, os diretórios
        serao incluidos em <aNomesArq>.  No vetor <aAtributos>, os
        diretórios sao indicados com um valor atributo de "D."  Se ADIR()
        for executado dentro de um subdiretório, as duas primeiras entradas
        do vetor <aNomesArq> sao "." e "..", os "alias" dos diretórios
        corrente e raiz.  A data e hora da última atualizaçao sao informadas
        para diretórios, mas o tamanho de um diretório é sempre zero.

 Exemplos

     Este exemplo cria um vetor que conterá os nomes de todos os arquivos
     (.txt) no diretório DEFAULT corrente, e os relaciona no console
     utilizando a funçao AEVAL():

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

 Arquivos:  Biblioteca EXTEND.LIB.
 To download this example - click here.

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