Usina BRAdvPL Guia
Entrar
← Todos os tópicos
CLASSEEm revisão

FWFileReader

FWFileReader():New(cFileName, [xBreakLine])

Percorre arquivos texto por linhas com buffer.

FWFileReaderAdvPL
01 · VISÃO GERAL

Visão geral

Para GetLine, o teste correto de continuação é HasLine: EOF é documentado para leitura por bytes. O buffer pode conter linhas mesmo após o fim da leitura física. FullRead e GetAllLines carregam conteúdo amplo e exigem avaliar memória; getBytesRead mede bytes obtidos para o buffer. O exemplo recebe um caminho completo preparado e conta linhas sem registrar seu conteúdo. Close ocorre após abertura bem-sucedida no caminho normal; o tratamento de exceções da aplicação deve garantir a limpeza também nas falhas inesperadas. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

FWFileReader():New(cFileName, [xBreakLine])

Parâmetros

cFileName
CaractereObrigatório

Caminho completo de teste no contexto de execução.

xBreakLine
CaractereOpcional

Separador de linhas opcional.

Métodos

Open / CloseAbertura lógica; fechar após sucesso.o:Open() / o:Close()
HasLineVerifica linhas no arquivo ou buffer.o:HasLine() --> lHasLine
GetLineLê próxima linha; opção preserva quebra.o:GetLine([lReturnCr]) --> cLine
FullReadLê todo conteúdo; respeitar limite de string.o:FullRead() --> cBuffer
03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento: cCaminho e um caminho completo de teste ja validado.
oLeitor := FWFileReader():New(cCaminho)
nLinhas := 0
If oLeitor:Open()
    // Nao usar EOF para consumir GetLine.
    While oLeitor:HasLine()
        cLinha := oLeitor:GetLine()
        nLinhas++
    EndDo
    oLeitor:Close()
EndIf
FreeObj(oLeitor)
Resultado esperado

Contagem conforme arquivo, sem impor número de linhas. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir versão da LIB, ciclo de vida e contexto antes de integrar à rotina completa. Métodos apresentados constituem um recorte documentado, não a API completa.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. FWFileReader. TDN. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha