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

MSFile

MsFile(cArquivo,[cIndice],[cDriver]) -> lExists

Consulta a existência de arquivo ou tabela pelo RDD.

MSFileAdvPL
01 · VISÃO GERAL

Visão geral

Recebe nome do artefato e, opcionalmente, índice e driver. O resultado de existência não confirma estrutura, acesso de escrita nem ausência de bloqueios. Não é abertura de handle de arquivo. Referência histórica: confirmar comportamento no release/RDD utilizado. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsFile(cArquivo,[cIndice],[cDriver]) -> lExists

Parâmetros

cArquivo
CaractereObrigatório

Artefato a consultar.

cIndice
CaractereOpcional

Índice conforme driver.

cDriver
CaractereOpcional

Driver RDD.

Retorno

Lógico indicando o resultado da operação descrita.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed539()
    // Bloco nao invocado; fornecer somente artefatos de teste autorizados.
    Local bOperacao := {|cDestino,cIndice,cRDD| MsFile(cDestino,cIndice,cRDD)}
    ConOut(ValType(bOperacao))
Return Nil
Resultado esperado

Imprime B. A operação não é executada; ao integrar, conferir o retorno lógico. 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 RDD, conexão, caminho e propriedade do destino. Tratar falhas, colisões e recursos abertos. Não usar este fragmento como backup ou migração de produção.
  • 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. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0, p. 359. Referência histórica. Consulta em 2026-10-27.
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