FUNCIóNEn revisión

FClose

FClose( [nHandle] ) --> lRet

Cierra handle de archivo propio de rutina.

FCloseAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

FClose devuelve verdadero al cerrar y falso al fallar; consultar FError después del fallo. Handle no es alias de tabla. Ejemplo comunitario crea archivo antes; adaptación abre prueba existente solo lectura, admite handle cero y cierra en ruta normal. Archivo ausente produce diagnóstico sin crear sustituto. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

FClose( [nHandle] ) --> lRet

Parámetros

nHandle

NuméricoOpcional

Handle válido a cerrar, explícito en ejemplo.

Retorno

Lógico de éxito del cierre.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

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

User Function Ed378()
    Local nHandle := FOpen("editorial-test.txt", FO_READ + FO_SHARED)
    // Handle cero es valido; no exigir mayor que cero.
    If nHandle >= 0
        If !FClose(nHandle)
            ConOut(cValToChar(FError()))
        EndIf
    Else
        ConOut(cValToChar(FError()))
    EndIf
Return Nil

Resultado esperado

Cierra tras apertura correcta; fallos muestran código sin contenido. 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:41
Última revisión el: 26/10/2026 a las 13:41
Idioma original: Portugués
Revisión: Usina.BR