fileSetPos

Move a posição de leitura e escrita.

Sintaxe

-- servidor
bool fileSetPos ( file oArquivo, number posicao )

-- cliente
number fileSetPos ( file oArquivo, number posicao )

Parâmetros

Nome	Tipo	Padrão	Descrição
oArquivo	file	—	Handle aberto.
posicao	number	—	Deslocamento em bytes a partir do início.

No servidor uma posição maior que o arquivo é limitada ao fim dele. No cliente, como no MTA, ela é mantida (até 50 MiB), e um fileWrite seguinte preenche o intervalo com bytes zero. Posições negativas são recusadas nos dois lados.

Retorno

No servidor, true em caso de sucesso, false se o handle for inválido ou a posição for negativa.

No cliente, a nova posição (nunca maior que o tamanho atual do arquivo), ou nil se o handle for inválido ou a posição for negativa.

Exemplo

fileSetPos(arquivo, 0)                          -- começo
fileSetPos(arquivo, fileGetSize(arquivo))       -- fim, para anexar

Veja também

• fileOpen — Abre um arquivo existente.
• fileCreate — Cria um arquivo novo, ou zera um que já exista.
• fileClose — Grava as alterações pendentes no disco e fecha o arquivo.
• fileFlush — Grava no disco o que foi escrito até agora, sem fechar o arquivo.
• fileRead — Lê bytes a partir da posição atual.
• fileWrite — Escreve uma ou mais strings a partir da posição atual.
• fileGetContents — Devolve o conteúdo inteiro do arquivo.
• fileGetSize — Devolve o tamanho do arquivo em bytes.