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ÇÃO

       A  função  fseek  seta  o indicador de posição de arquivo do fluxo apontado por stream.  A
       nova posição, medida em  bytes,  é  obtida  pelo  acréscimo  de  offset  bytes  à  posição
       especificada  por  whence.   Se  whence  é  setado para SEEK_SET, SEEK_CUR, ou SEEK_END, o
       offset é relativo ao início do arquivo, ao indicador de posição corrente,  ou  ao  fim  de
       arquivo, respectivamente. Uma chamada bem-sucedida à função fseek limpa o indicador de fim
       de arquivo para o fluxo e desfaz qualquer efeito da função ungetc(3) no mesmo fluxo.

       A função ftell obtém o valor corrente do indicador de posição de arquivo do fluxo apontado
       por stream.

       A função rewind seta o indicador de posição de arquivo do fluxo apontado por stream para o
       início do arquivo. É equivalente a:

              (void)fseek(stream, 0L, SEEK_SET)

       exceto pelo fato de que o indicador de erro do fluxo também é limpo (veja clearerr(3)).

       As funções fgetpos e fsetpos são 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  não-UNIX,  um  objeto  fpos_t
       pode  ser  um  objeto  complexo  e  estas  rotinas  podem  ser a única maneira portável de
       reposicionar um fluxo de texto.

VALORES DE RETORNO

       A função rewind não retorna valor.  Em  caso  de  término  bem-sucedido,  fgetpos,  fseek,
       fsetpos  retornam 0, e ftell retorna o offset corrente. Caso contrário, -1 é retornado e a
       variável global errno é setada para indicar o erro.

ERROS

       EBADF  O fluxo especificado não é um fluxo vasculhável.

       EINVAL O argumento whence de fseek não era SEEK_SET, SEEK_END, ou SEEK_CUR.

       As funções fgetpos, fseek, fsetpos, e  ftell  também  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ÉM

       lseek(2)

PADRÕES

       As funções fgetpos, fsetpos, fseek,  ftell,  e  rewind  estão  em  conformidade  com  ANSI
       X3.159-1989 (``ANSI C'').

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       RUBENS  DE  JESUS  NOGUEIRA  <darkseid99@usa.net>  (tradução)  XXXXXX  XX  XXXXX  XXXXXXXX
       <xxxxxxxxxx@xxx.xxx> (revisão)