Cabeçalho

FSeek [AS]

Autor: Eurai Criado: 01/01/2016 Atualizado: 25/04/2025 Arquivos de Disco/IO

Postagem

Descrição

FSeek [AS] - POSICIONA O PONTEIRO DO ARQUIVO PARA AS PRÓXIMAS OPERAÇÕES DE LEITURA OU GRAVAÇÃO.

Sintaxe

FSEEK( <NHANDLE>, <NOFFSET>, <NORIGEM> )

Parâmetros

Par	Nome	Tipo	Descrição	Default	Obg	Ref
01	NHANDLE	Numérico	Indica o manipulador do arquivo obtido através das funções FCreate() e FOpen		X
02	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
03	NORIGEM	Numérico	Indica a partir de qual posição o número de bytes, do parâmetro , será movido		X

Retorno

Retorno	Tipo	Descrição
nRet	Numérico	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()

Exemplo

#INCLUDE "TOTVS.CH"
#INCLUDE "FILEIO.CH"

User Function FSeek()
Local nHandle := 0
Local nTamanho := 0

If ( nHandle := FOPEN("C:\TEMP\TST.TXT") ) >= 0 
 nTamanho := FSEEK(nHandle, 0, FS_END) 
 FSEEK(nHandle, 0) 
 FCLOSE(nHandle)
Else
 MsgStop( "Erro abrir Arquivo", 'UniversoADVPL' )
Endif

Return( Nil )

Resultado
fseek_-_resultado_01

Informações adicionais

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