Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Portuguese

Pagetitle
FSeek
FSeek

Função: FSeek

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

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

 

NomeTipoDescriçãoObrigatórioReferência
nHandleNuméricoIndica o manipulador do arquivo obtido através das funções FCreate() e FOpen.X 
nOffSetNuméricoIndica 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 
nOrigemNuméricoIndica a partir de qual posição o número de bytes, do parâmetro , será movido.  

 

nRet
    (numerico)
  • 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().

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

origemconstanteoperação
0FS_SETAjusta a partir do início do arquivo. (Padrão)
1FS_RELATIVEAjuste relativo a posição atual do arquivo.
2FS_ENDAjuste a partir do final do arquivo.

 

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

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