FUNCIóNEn revisión

FCreate

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

Crea archivo vacío o trunca uno existente.

FCreateAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

FCreate no es apertura neutra: vacía archivo existente. Handle válido es mayor/igual a cero; -1 indica fallo. Compatibilidad debe quedar Nil/cero según ficha; lChangeCase depende de build/configuración. GitHub crea TEST.TXT sin comprobar creación antes de cerrar. Adaptación prepara callback sin ejecutarlo. File previo no elimina carrera concurrente. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

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

Parámetros

cArquivo

CarácterObligatorio

Nombre y ruta de creación.

nAtributo

NuméricoOpcional

Compatibilidad: Nil o cero.

xParam3

CualquieraOpcional

Compatibilidad: Nil.

lChangeCase

LógicoOpcional

Ajuste de mayúsculas según build/configuración.

Retorno

Handle >= 0; -1 en fallo.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

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

User Function Ed380()
    Local bCrear := {|cNuevoArchivo| FCreate(cNuevoArchivo)}
    // No evaluar: FCreate puede eliminar contenido existente.
Return Nil

Resultado esperado

Bloque preparado sin crear ni truncar archivo. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

Comprobar ruta, permisos, plataforma y propiedad del handle. Cerrar solo handles propios, incluido manejo de errores de aplicación completa.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

Estado: En revisión
Página creada el: 26/10/2026 a las 13:42
Última revisión el: 26/10/2026 a las 13:42
Idioma original: Portugués
Revisión: Usina.BR