PT-BR/fileSetPos

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Define a posição atual para leitura/gravação no arquivo.

Sintaxe

int fileSetPos ( file theFile, int offset )

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

Método: file:setPos(...)
Variável: .pos
Oposto: PT-BR/fileGetPos

Argumentos necessários

  • theFile: O arquivo que você quer mudar a posição de leitura/gravação.
  • offset: A nova posição. Este é o número de bytes partindo do início do arquivo. Se este número for maior que o tamanho do arquivo, então será limitado para 52,428,800 bytes (50 MB).

Retorno

Retorna onde realmente foi definido o offset. Ou seja, se offset ultrapassar o final do arquivo, então esse valor será a posição do fim do arquivo, que é o que será retornado. Retorna false em caso de falha (ex.: o arquivo especificado for inválido).

Exemplo

Este exemplo abre um arquivo binário e exibe no console o valor do byte na posição 8.

local hFile = fileOpen("test.dat")          -- tentamos abrir o arquivo
if hFile then                               -- verificamos se foi aberto
    fileSetPos(hFile, 8)                    -- define a posição de leitura/gravação
    local readByte = fileRead(hFile, 1)     -- faz a leitura de um byte nesta posição
    outputConsole("Byte at position 8 = " .. string.byte(readByte))     -- então exibe
    fileClose(hFile)                        -- fechamos o arquivo
else
    outputConsole("Unable to open test.dat")
end

Veja também