Histórico da Página

...

Portuguese

Pagetitle

	FSeek
	FSeek

Colapse ALL

Expand ALL

Função: FSeek

Posiciona o ponteiro do arquivo para as próximas operações de leitura ou gravação.

Sintaxe

FSeek ( < nHandle>, < nOffSet>, [ nOrigem] ) --> nRet

Parâmetros/Elementos

Nome	Tipo	Descrição	Obrigatório	Referência
nHandle	Numérico	Indica o manipulador do arquivo obtido através das funções FCreate() e FOpen.	X
nOffSet	Numérico	Indica o número de bytes que o ponteiro de arquivo será movido a partir da posição definida no parâmetro . Esse número pode ser positivo, negativo ou zero, dependendo da direção na qual o ponteiro será movido.	X
nOrigem	Numérico	Indica a partir de qual posição o número de bytes, do parâmetro , será movido.

Retorno

nRet

Retorna a nova posição do ponteiro de arquivo, com relação ao início do arquivo (posição 0), na forma de um valor numérico inteiro. Este valor não considera a posição original do ponteiro de arquivos antes da execução da função FSeek().

Observações

As movimentações dos ponteiros são relativas ao parâmetro nOrigem, que pode ter os valores definidos no arquivo header fileio.ch.

Tabela - Origem de movimentação do ponteiro

origem	constante	operação
0	FS_SET	Ajusta a partir do início do arquivo. (Padrão)
1	FS_RELATIVE	Ajuste relativo a posição atual do arquivo.
2	FS_END	Ajuste a partir do final do arquivo.

Exemplos

IF

(nHandle

:=

FOPEN("c:\garbage\test.txt"))

>=

0

//

Posiciona

no

fim

do

arquivo,

retornando

o

tamanho

do

mesmo

nLength

:=

FSEEK(nHandle,

0,

FS_END)

//

Posiciona

no

início

do

arquivo

FSEEK(nHandle,

0)

//

Fecha

arquivo

FCLOSE(nHandle)
ELSE

MsgStop(

"File

open

error"

)
ENDIF

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

Função: FSeek

Tabela - Origem de movimentação do ponteiro