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

File

File( cArquivo, [nWhere], [lChangeCase] ) --> lRet

Comprueba archivo según búsqueda definida.

FileAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

File devuelve lógico y acepta comodines; verdadero no prueba archivo único. nWhere elige servidor/SmartClient y cero depende de ruta. Documentación excluye ocultos/sistema y limita JOB con rutas de estación. Ejemplo usa nWhere=1 y nombre ficticio sin unidad, sin abrir, crear ni garantizar exclusividad. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

File( cArquivo, [nWhere], [lChangeCase] ) --> lRet

Parámetros

cArquivo
CarácterObligatorio

Nombre o máscara.

nWhere
NuméricoOpcional

0 depende de ruta; 1 servidor; 2 SmartClient.

lChangeCase
LógicoOpcional

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

Retorno

Lógico de búsqueda de archivo.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

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

User Function Ed386()
    // Buscar en servidor sin suponer archivo de prueba existente.
    ConOut(cValToChar(File("editorial-test.txt", 1, .F.)))
Return Nil
Resultado esperado

Verdadero o falso según archivo/contexto; no prueba permiso de escritura. 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. File. TDN. 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