nHandleNuméricoObligatorio
Handle válido de FOpen/FCreate; cero también es válido.
FUNCIóNEn revisión
FREADSTR()
FReadStr( nHandle, nQtdBytes ) --> cRetLee hasta límite de bytes y devuelve texto.
Descripción general
FReadStr devuelve string, distinta del conteo FRead. Puede parar en Chr(0), fin o error; no sustituye lectura binaria que preserve nulos. GitHub usa apertura grabable; adaptación solo lectura y captura diagnóstico antes de cerrar. Longitud depende de archivo/posición y no equivale a caracteres Unicode. (TOTVS, s.f., ref. 1)
Sintaxis
FReadStr( nHandle, nQtdBytes ) --> cRetParámetros
nQtdBytesNuméricoObligatorio
Límite de bytes solicitado.
Retorno
Texto leído hasta límite, nulo o fin.
Ejemplo comentado
#Include "Protheus.ch"
#Include "Fileio.ch"
User Function Ed394()
Local nHandle := -1
Local nError := 0
Local cTexto
// 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
cTexto := FReadStr(nHandle, 64)
nError := FError()
// Informar tamano sin exponer contenido.
ConOut(cValToChar(Len(cTexto)))
If nError <> 0
ConOut(cValToChar(nError))
EndIf
If !FClose(nHandle)
ConOut(cValToChar(FError()))
EndIf
EndIf
Return NilResultado esperado
Longitud hasta 64 bytes o diagnóstico; no muestra contenido. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.
- 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.
Comentarios
Todavía no hay comentarios aprobados.
Inicia sesión con Google o Microsoft para comentar.