Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

FOpen

FOpen( cArq, [nModo], [xParam3], [lChangeCase] ) --> nRet

Abre archivo existente y devuelve handle.

FOpenAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

FOpen no crea archivo ausente. nModo combina acceso/compartición Fileio.ch; ejemplo usa lectura compartida, fuente comunitario solicita lectura/escritura. Handle cero válido y -1 fallo. Búsqueda no sigue Set Default/Set Path AdvPL según ficha; lChangeCase importa en nombres sensibles. editorial-test.txt debe existir en contexto de prueba; solo se cierra handle propio. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

FOpen( cArq, [nModo], [xParam3], [lChangeCase] ) --> nRet

Parámetros

cArq
CarácterObligatorio

Nombre con ruta si corresponde.

nModo
NuméricoOpcional

Acceso + compartición Fileio.ch.

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 Ed388()
    Local nHandle := -1
    Local nError := 0

    // Archivo ficticio existente en contexto de prueba; lectura compartida.
    nHandle := FOpen("editorial-test.txt", FO_READ + FO_SHARED)
    If nHandle < 0
        nError := FError()
        ConOut(cValToChar(nError))
    Else
        ConOut("Archivo abierto para lectura")
        If !FClose(nHandle)
            ConOut(cValToChar(FError()))
        EndIf
    EndIf
Return Nil
Resultado esperado

Mensaje de apertura y cierre, o código de fallo. 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
  1. TOTVS. FOpen. TDN. Consulta el 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Arquivos de Disco/FOpen.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta el 2026-10-26.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha