Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 2 Próxima »

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

 

  • Sem rótulos