Provided by: manpages-pt-dev_20040726-4_all bug

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)