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

File

File( cArquivo, [nWhere], [lChangeCase] ) --> lRet

Verifica se um arquivo corresponde à procura definida.

FileAdvPL
01 · VISÃO GERAL

Visão geral

File retorna lógico e aceita curingas; por isso verdadeiro não prova que há exatamente um arquivo com um nome único. nWhere define a procura no servidor ou SmartClient, com comportamento dependente do caminho quando zero. A documentação não inclui arquivos ocultos/de sistema nessa busca e descreve limitações em JOB com caminhos da estação. O exemplo usa nWhere=1 e nome fictício sem unidade, sem abrir, criar ou garantir exclusividade de arquivo. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

File( cArquivo, [nWhere], [lChangeCase] ) --> lRet

Parâmetros

cArquivo
CaractereObrigatório

Nome ou máscara do arquivo.

nWhere
NuméricoOpcional

0 depende do caminho; 1 servidor; 2 SmartClient.

lChangeCase
LógicoOpcional

Ajuste de caixa de nomes conforme build/configuração.

Retorno

Lógico da procura de arquivo.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"
#Include "Fileio.ch"

User Function Ed386()
    // Procura no servidor sem assumir existencia do arquivo de teste.
    ConOut(cValToChar(File("editorial-test.txt", 1, .F.)))
Return Nil
Resultado esperado

Verdadeiro ou falso conforme contexto e arquivo; não comprova permissão de escrita. 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, permissões, plataforma e propriedade do handle. Fechar somente handles obtidos pela própria rotina, inclusive em tratamento de erros da aplicação completa.
  • 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. File. TDN. 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