Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

Directory

Directory( cDirEsp, [cAtributos], [uParam1], [lConvertCase], [nTypeOrder] ) --> aRet

Lista entradas de um diretório em um array.

DirectoryAdvPL
01 · VISÃO GERAL

Visão geral

Directory devolve nome, tamanho, data, hora e atributos por entrada. A unidade no caminho distingue estação e servidor nos exemplos da TOTVS; SmartClient HTML exige WebAgent, conforme o aviso da página. O limite de 10.000 entradas e a paginação por atributo :N são condicionados à build indicada na fonte. O exemplo público lista C:\TEMP; a adaptação apenas prepara uma consulta de pasta de teste no servidor e não imprime nomes de arquivos. Não interpretar uma lista vazia como comprovação de autorização ou existência. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

Directory( cDirEsp, [cAtributos], [uParam1], [lConvertCase], [nTypeOrder] ) --> aRet

Parâmetros

cDirEsp
CaractereObrigatório

Diretório e máscara de busca.

cAtributos
CaractereOpcional

Atributos de seleção; D inclui diretórios.

uParam1
NuméricoOpcional

Compatibilidade; não preencher.

lConvertCase
LógicoOpcional

Verdadeiro converte nomes para maiúsculas.

nTypeOrder
NuméricoOpcional

Ordenação conforme build: nome, data ou tamanho.

Retorno

Array de entradas com cinco posições por item.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed352()
    Local bListar := {|| Directory("/editorial/*.*", "D")}
    // Caminho de teste preexistente; callback nao executado.
Return Nil
Resultado esperado

Ação preparada sem consultar o sistema de arquivos. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir caminho e permissões; uParam1 é reservado para compatibilidade e não deve ser preenchido.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Directory. TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Arquivos de Disco/Directory.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha