Provided by:
manpages-pt-dev_20040726-4_all 
NOME
fgetpos, fseek, fsetpos, ftell, rewind - reposiciona um fluxo
SINOPSE
#include <stdio.h>
int fseek( FILE *stream, long offset, int whence);
long ftell( FILE *stream);
void rewind( FILE *stream);
int fgetpos( FILE *stream, fpos_t *pos);
int fsetpos( FILE *stream, fpos_t *pos);
DESCRI,C~AO
A funcao fseek seta o indicador de posicao de arquivo do fluxo apontado
por stream. A nova posicao, medida em bytes, e obtida pelo acrescimo
de offset bytes a posicao especificada por whence. Se whence e setado
para SEEK_SET, SEEK_CUR, ou SEEK_END, o offset e relativo ao inicio do
arquivo, ao indicador de posicao corrente, ou ao fim de arquivo,
respectivamente. Uma chamada bem-sucedida a funcao fseek limpa o
indicador de fim de arquivo para o fluxo e desfaz qualquer efeito da
funcao ungetc(3) no mesmo fluxo.
A funcao ftell obtem o valor corrente do indicador de posicao de
arquivo do fluxo apontado por stream.
A funcao rewind seta o indicador de posicao de arquivo do fluxo
apontado por stream para o inicio do arquivo. E equivalente a:
(void)fseek(stream, 0L, SEEK_SET)
exceto pelo fato de que o indicador de erro do fluxo tambem e limpo
(veja clearerr(3)).
As funcoes fgetpos e fsetpos sao interfaces alternativas equivalentes a
ftell e fseek (com whence setado para SEEK_SET), configurando e
armazenando o valor corrente do offset do arquivo do objeto
referenciado por pos. Em alguns sistemas nao-UNIX, um objeto fpos_t
pode ser um objeto complexo e estas rotinas podem ser a unica maneira
portavel de reposicionar um fluxo de texto.
VALORES DE RETORNO
A funcao rewind nao retorna valor. Em caso de termino bem-sucedido,
fgetpos, fseek, fsetpos retornam 0, e ftell retorna o offset corrente.
Caso contrario, -1 e retornado e a variavel global errno e setada para
indicar o erro.
ERROS
EBADF O fluxo especificado nao e um fluxo vasculhavel.
EINVAL O argumento whence de fseek nao era SEEK_SET, SEEK_END, ou
SEEK_CUR.
As funcoes fgetpos, fseek, fsetpos, e ftell tambem podem falhar e setar
errno para qualquer um dos erros especificados para as rotinas
fflush(3), fstat(2), lseek(2), e malloc(3).
VEJA TAMB'EM
lseek(2)
PADR~OES
As funcoes fgetpos, fsetpos, fseek, ftell, e rewind estao em
conformidade com ANSI X3.159-1989 (``ANSI C'').
TRADU,C~AO PARA A L'INGUA PORTUGUESA
RUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (traducao) XXXXXX XX
XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisao)