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

FCreate

FCreate( cArquivo, [nAtributo], [xParam3], [lChangeCase] ) --> nRet

Cria um arquivo vazio ou trunca um existente.

FCreateAdvPL
01 · VISÃO GERAL

Visão geral

FCreate não é uma abertura neutra: se o nome já existir, seu conteúdo é eliminado. O handle válido é maior ou igual a zero; -1 indica falha. Os argumentos de compatibilidade devem permanecer Nil/zero conforme a ficha; lChangeCase tem regras de build e configuração. O exemplo GitHub cria TEST.TXT sem validar a criação antes de fechar. A adaptação apenas prepara um callback e não o executa. Uma consulta File anterior não elimina uma corrida com outro processo. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

FCreate( cArquivo, [nAtributo], [xParam3], [lChangeCase] ) --> nRet

Parâmetros

cArquivo
CaractereObrigatório

Nome e caminho da criação.

nAtributo
NuméricoOpcional

Compatibilidade: Nil ou zero.

xParam3
QualquerOpcional

Compatibilidade: Nil.

lChangeCase
LógicoOpcional

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

Retorno

Handle >= 0; -1 em falha.

03 · EXEMPLO PRÁTICO

Exemplo comentado

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

User Function Ed380()
    Local bCriar := {|cNovoArquivo| FCreate(cNovoArquivo)}
    // Nao avaliar: FCreate pode eliminar conteudo existente.
Return Nil
Resultado esperado

Bloco preparado sem criar ou truncar arquivo. 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. FCreate. TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Arquivos de Disco/FCreate.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