PT-BR/fileGetContents

BETA: NOVO RECURSO (BUILD: 1.6.0 r21938)

Faz a leitura de todo o conteúdo do arquivo, opcionalmente verifica o arquivo lido calculando e comparando a soma de verificação com o que é esperado, e retorna o conteúdo em formato de string. A posição do cursor (caret) do arquivo não é modificada pelas execuções dessa função.

Por favor note que sempre que você habilitar SD #22 e #23 no seu servidor, você não estará protegido por ataques, que podem acontecer depois da verificação do arquivo, mas antes de ler o conteúdo de cada arquivo verificado. Essa função te permite, de uma forma segura, ler o conteúdo dos arquivos (que estão listados no meta.xml) tanto no lado client quanto server.

Sintaxe

nil|string fileGetContents ( file theFile [ , bool verifyContents = true ] )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: file:getContents(...)

Argumentos necessários

theFile: O arquivo que você deseja obter o conteúdo. Use fileOpen para obter esse arquivo.
verifyContents: Defina para true, para comparar o cálculo e a soma de verificação esperada do conteúdo do arquivo.

Retorna

Retorna o conteúdo (bytes) que foram lidos do arquivo, mas apenas se a verificação for desabilitada ou se a comparação da soma de verificação tiver sido feita com sucesso. No caso de falha, essa função retorna nil.

Exemplo

This example opens the code.lua file, checks its contents, and then runs it. Este exemplo abre o arquivo "code.lua", verifica seu conteúdo e então roda ele.

local handle = fileOpen("code.lua", true)
local buffer = fileGetContents(handle) -- "code.lua" deve estar especificado no meta.xml (por exemplo como <file> para este exemplo)
fileClose(handle)

if buffer then
    loadstring(buffer)()
end

Veja tammbém

BETA: DA VERSÃO 1.6.0 r21938 ADIANTE

fileGetContents