nHandleNuméricoObrigatório
Handle gravável aberto.
FUNçãOEm revisão
FWrite
FWrite(nHandle,cBuffer,[nBytes]) -> nWrittenEscreve bytes em um handle de arquivo aberto.
Visão geral
Recebe handle obtido por FCreate/FOpen com permissão de escrita. O retorno informa a quantidade efetivamente escrita; não confundir zero ou escrita parcial com sucesso. O fragmento é uma função auxiliar que recebe handle já aberto, sem criar, truncar ou fechar arquivo que pertença ao chamador. (Fontes: refs. 1–1.)
Sintaxe
FWrite(nHandle,cBuffer,[nBytes]) -> nWrittenParâmetros
cBufferCaractereObrigatório
Bytes a gravar.
nBytesNuméricoOpcional
Quantidade de bytes.
Retorno
Número de bytes escritos.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed449()
// Auxiliar recebe handle de teste pertencente ao chamador.
Local bWrite := {|nHandle,cBuffer| FWrite(nHandle,cBuffer,Len(cBuffer))}
ConOut(ValType(bWrite))
Return NilResultado esperado
Prepara bloco B; comparar seu retorno com Len(cBuffer) ao executá-lo. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir FError após falha e definir tratamento de escrita parcial. O chamador mantém responsabilidade pelo fechamento.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.