Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Current »

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

Sintaxe

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

Parâmetros

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

Nome

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().

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

#include 'fileio.ch'...
User Function exemplo()
  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
Return

Veja também

  • No labels