Função: FSeek
Posiciona o ponteiro do arquivo para as próximas operações de leitura ou gravação.
FSeek ( < nHandle>, < nOffSet>, [ nOrigem] ) --> nRet
| 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. |
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
| 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. |
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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas