fileGetContents

Devolve o conteúdo inteiro do arquivo.

Sintaxe

string fileGetContents ( file oArquivo [, bool verificarConteudo = true ] )

Ignora a posição atual e não a altera. Inclui o que você escreveu e ainda não gravou no disco.

No servidor o segundo argumento é aceito, mas não muda nada. No cliente o conteúdo é conferido com o checksum do arquivo que o resource baixou, a menos que verificarConteudo seja false; assim, um arquivo que o manifest não lista, ou cujo conteúdo mudou desde o download, devolve nil com um aviso. Passe false para ler esses arquivos.

Retorno

O conteúdo como string, ou nil se o handle for inválido (servidor) ou a verificação falhar (cliente).

No cliente, um handle inválido, ou um verificarConteudo que não seja booleano, levanta um erro (Bad argument @ 'fileGetContents' [...]) que interrompe o código chamador em vez de retornar; envolva a chamada em pcall se precisar se recuperar.

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