Descrição
FReadStr [AS] - Lê caracteres de um arquivo binário para uma variável de buffer .
|
Sintaxe
| FReadStr( <nHandle>, <nQtdBytes> ) |
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
01
|
nHandle
|
Numérico |
Indica o handle do arquivo obtido pelas funções FOpen(), FCreate() ou pré-definido pelo DOS – Disk Operating System
|
|
X |
|
| 02 |
nQtdBytes |
Numérico |
Indica a quantidade de bytes que devem ser lidos do arquivo a partir do posicionamento do ponteiro atual |
|
X |
|
Retorno
| Retorno |
Tipo |
Descrição |
| cRet |
Caracter
|
Retorna uma string contendo os caracteres lidos
|
Exemplo
#INCLUDE "TOTVS.CH"
#INCLUDE 'FILEIO.CH'
User Function FReadStr()
Local cString := ''
Local nHandle := fOpen('\TEST.TXT' , FO_READWRITE + FO_SHARED )
If nHandle == -1
MsgStop('Erro de abertura : FERROR ' + Str(fError(), 4), 'UniversoADVPL' )
Else
cString := FReadStr( nHandle, 1024 )
fclose(nHandle) // Fecha arquivo
Endif
Return( Nil )
Resultado
Informações adicionais
|
Lê os dados a partir de um arquivo aberto, através das funções FOpen() e FCreate(), e armazena os dados por referência no buffer informado
|
|
Lê até o número de bytes informado no parâmetro <nQtdBytes> ou até encontrar um CHR (0). Caso aconteça algum erro ou o arquivo chegue ao final, a função retornará uma string menor que a especificada, no parâmetro <nQtdBytes>, e colocará o erro na função FError().
|
|
Lê a partir da posição atual do ponteiro, que pode ser ajustado pelas funções FSeek(), FWrite() ou FRead().
|
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎
