Lettify: Created page with "NOTOC {{BR/Funcao compartilhada}} Retorna a posição atual na leitura/gravação de um determinado arquivo. ==Sintaxe== int fileGetPos ( file theFile ) {{PT-BR/POO||file:getPos|pos|PT-BR/fileSetPos}} ===Argumentos necessários=== *'''theFile:''' o '''arquivo''' que você deseja obter a posição. ===Retorna=== Retorna a posição do arquivo, ou ''false'' se tiver ocorrido algum erro (ex.: um '''arquivo''' inv..."

2023-12-20T18:51:16Z

Created page with "__NOTOC__ {{BR/Funcao compartilhada}} Retorna a posição atual na leitura/gravação de um determinado arquivo. ==Sintaxe== <syntaxhighlight lang="lua"> int fileGetPos ( file theFile ) </syntaxhighlight> {{PT-BR/POO||file:getPos|pos|PT-BR/fileSetPos}} ===Argumentos necessários=== *'''theFile:''' o '''arquivo''' que você deseja obter a posição. ===Retorna=== Retorna a posição do arquivo, ou ''false'' se tiver ocorrido algum erro (ex.: um '''arquivo''' inv..."

New page

__NOTOC__
{{BR/Funcao compartilhada}}

Retorna a posição atual na leitura/gravação de um determinado arquivo.

==Sintaxe==
<syntaxhighlight lang="lua"> int fileGetPos ( file theFile ) </syntaxhighlight>

{{PT-BR/POO||[[file]]:getPos|pos|PT-BR/fileSetPos}}

===Argumentos necessários===
*'''theFile:''' o '''arquivo''' que você deseja obter a posição.

===Retorna===
Retorna a posição do arquivo, ou ''false'' se tiver ocorrido algum erro (ex.: um '''arquivo''' inválido for especificado).

==Exemplo==
Este exemplo abre o arquivo "test.txt" e exibe o seu conteúdo e a posição de leitura atual no console.
<syntaxhighlight lang="lua">
local hFile = fileOpen("test.txt", true) -- tentamos abrir o arquivo (em modo leitura)
if hFile then -- verificamos se foi aberto com sucesso
local buffer
while not fileIsEOF(hFile) do -- desde que não estejamos no fim do arquivo...
buffer = fileRead(hFile, 500) -- ... lemos os próximos 500 bytes ...
outputConsole(buffer.."Current Position: "..fileGetPos(hFile)) -- ... então exibimos o conteúdo desta parte e a posição de leitura atual no console
end
fileClose(hFile) -- fechamos o arquivo depois que terminarmos com ele
else
outputConsole("Unable to open test.txt")
end
</syntaxhighlight>

==Veja também==
{{PT-BR/File functions}}

PT-BR/fileGetPos - Revision history