Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin
Composition Setup
import.css=/download/attachments/6062824/tecnologia.css
Portuguese

Pagetitle
Directory
Directory

Função: Directory

Cria um array bidimensional com o conteúdo de um diretório.
Para isso, retorna informações a respeito dos arquivos no diretório corrente ou especificado. Essa função é semelhante a ADir(), porém, retorna um único array ao invés de adicionar valores a uma séria de arrays existentes passados por referência.

 

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

 

NomeTipoDescriçãoObrigatórioReferência
cDirEspCaracterIndica o diretório que será pesquisado e os arquivos que serão apresentados. Além disso, caracteres do tipo curinga são permitidos na especificação de arquivos. Caso esse parâmetro não seja especificado, o valor padrão é *.*.X 
cAtributosCaracterIndica quais arquivos com atributos especiais devem ser incluídos no array. Esse parâmetro consiste em uma string que contém um ou mais dos caracteres H, S, D e V. Para mais detalhes, consulte a tabela A na área Observações.  
xParam3NuloCompatibilidade. Deve ser informado o valor nulo ( NIL )  
lCaseSensitiveLógicoIndica se, verdadeiro (.T.), o nome do arquivo será transformado para letra maiúscula; caso contrário, falso (.F.), o nome do arquivo será retornado conforme escrito no disco rígido.  

 

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.
Nota
titleAtenção!

 Quando executado via SmartClient HTML, o sistema não tem acesso aos arquivos da estação (Remote).

Tabela A - Atributos de Directory() 

AtributoSignificado
HIncluir arquivos ocultos
SIncluir arquivos de sistema
DIncluir diretórios
VProcura pelo volume DOS e exclui outros arquivos


 

Importante

Arquivos normais são sempre incluídos na pesquisa, a não ser que "V" seja especificado.

 

 

Tabela B - Estrutura dos subarrays

posiçãometasímbolodirectry.ch
 1cNomeF_NAME
 2cTamanhoF_SIZE
 3dDataF_DATE
 4cHoraF_TIME
 5cAtributosF_ATT

 

 

Bloco de código
themeEclipse
languagecpp
titleExemplo
linenumberstrue
Local aFiles := {} 
Local nX
local nCount := Len( aFiles )


aFiles := Directory("c:\garbage\*.*", "D")

For nX := 1 to nCount  
	ConOut('Arquivo: ' + aFiles[nX,1] + ' - Size: ' + AllTrim(Str(aFiles[nX,2])) )
Next nX
Bloco de código
themeEclipse
languagecpp
titleExemplo
linenumberstrue
#INCLUDE "Directry.ch"

aDirectory := DIRECTORY("*.*", "D")

AEVAL(aDirectory, {|aFile| CONOUT(aFile[F_NAME])} )

 

 
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server