Histórico da Página

Directory ( < cDirEsp>, [ cAtributos], [ xParam3], [ lCaseSensitive] ) --> aRet

aRet(vetor)
• Retorna um array de subarrays, sendo que cada subarray contém informações sobre cada arquivo que atenda o parâmetro (<cDirSpec>). Para mais detalhes, consulte a tabela B na área Observações.

• O diretório especificado, no parâmetro <cDirEsp> , pode estar na estação (Remote) ou no servidor, porém, é necessário obedecer as definições de Path Absoluto/Relativo de acesso.
• Essa função pode ser utilizada para realizar operações em conjuntos de arquivos. Ao utilizar essa função em conjunto com AEVal(), é possível definir um bloco de código que pode ser aplicado a todos os arquivos que atendam ao parâmetro especificado.
• Para tornar as referências aos vários elementos de cada subarray de arquivo mais legíveis, a linguagem AdvPL fornece o arquivo header Directory.ch, que contém os #DEFINES para os subarrays subscripts.

Tabela A - Atributos de Directory() 

Tabela B - Estrutura dos subarrays

//Exemplo 1Local aFiles := {} // O array receberá os dados dos arquivosLocal nXaFiles := Directory("c:\garbage\*.*", "D")// Apresenta os dados dos arquivosnCount := Len( aFiles )For nX := 1 to nCount  ConOut( 'Arquivo: ' + aFiles[nX,1] + ' - Size: ' + AllTrim(Str(aFiles[nX,2])) )Next nX//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////Exemplo 2//Através do exemplo abaixo, obtemos no array aDirectory todos os diretórios no ambiente do servidor a partir do path atual.      #INCLUDE "Directry.ch"      aDirectory := DIRECTORY("*.*","D")      AEVAL( aDirectory, {|aFile| CONOUT(aFile[F_NAME])} )