Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/327912/newLayout.css
Portuguese
Pagetitle
FReadStr
FReadStr

Função: FReadStr

caracteres

de

um

arquivo

binário.

Sintaxe

Bloco de código
collapsefalse
FReadStr( <
nHandle>
 nHandle >, <
nQtdBytes> ) --> cRet
 nQtdBytes > )

Parâmetros

/Elementos

Nome

Tipo

Descrição

Obrigatório

Referência

nHandle

Numérico

numérico

Indica o

manipulador retornado

handle do arquivo obtido pelas funções FOpen()

e

, FCreate().

X

 

nQtdBytes

Numérico

numérico

Indica

o número máximo

a quantidade de bytes que devem ser lidos do arquivo a partir do posicionamento do ponteiro atual.

X

 

Retorno

Nome

Tipo

Descrição

cRet

(caracter)

caractere

Retorna uma string contendo os caracteres lidos.

Observações

A função FReadStr:

Lê de
  • Lê de um arquivo aberto, através das funções FOpen()
 e
  • e FCreate().
  • 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
  • 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().

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
#include 'fileio.ch'
user function teste()
  nHandle := fopen('c:\garbage\test.txt' , FO_READWRITE + FO_SHARED )
  cString := FReadStr( nHandle, 10 )
  // Lê os primeiros 10 bytes do 
arquivoMsgAlert
arquivo
  MsgAlert( cString )
return nil

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

Veja

Também

também

, , , , ,