fileWrite

Escreve uma ou mais strings a partir da posição atual.

Sintaxe

number fileWrite ( file oArquivo, string dados [, ... ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oArquivo	file	—	Handle aberto com permissão de escrita.
dados	string	—	Conteúdo a gravar.
...	string	—	Mais strings, gravadas em sequência. No servidor um argumento que não for string é ignorado; no cliente a escrita para no primeiro.

A escrita sobrescreve o que estiver na posição atual e aumenta o arquivo quando necessário; ela não insere. A posição avança conforme os bytes são gravados. O conteúdo só chega ao disco em fileFlush, fileClose ou quando o resource para.

Retorno

O total de bytes gravados, ou nil se o handle for inválido ou se o primeiro argumento depois do handle não for uma string. Um handle aberto como somente leitura devolve nil no servidor e 0 no cliente.

Exemplo

local arquivo = fileOpen("logs/chat.txt")
fileSetPos(arquivo, fileGetSize(arquivo))
fileWrite(arquivo, "[", getPlayerName(jogador), "] ", mensagem, "\n")
fileClose(arquivo)

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.
• fileGetContents — Devolve o conteúdo inteiro do arquivo.
• fileGetSize — Devolve o tamanho do arquivo em bytes.
• fileGetPos — Devolve a posição atual de leitura e escrita.