Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       fgetpos, fseek, fsetpos, ftell, rewind - Positionner un flux

SYNOPSIS

       #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);

DESCRIPTION

       La  fonction  fseek()  fixe l'indicateur de position du flux pointe par
       stream. La  nouvelle  position,  mesuree  en  octets,  est  obtenue  en
       additionnant  offset  octets  au point de depart indique par whence. Si
       whence vaut  SEEK_SET,  SEEK_CUR,  ou  SEEK_END,  le  point  de  depart
       correspond  respectivement au debut du fichier, a la position actuelle,
       ou a la fin du fichier. Un appel reussi a fseek()  efface  l'indicateur
       de  fin  de  fichier  du  flux,  et annule les effets de toute fonction
       ungetc(3) sur le meme flux.

       La fonction ftell() obtient la valeur de l'indicateur  de  position  du
       flux pointe par stream.

       La  fonction rewind() place l'indicateur de position du flux pointe par
       stream au debut du fichier. C'est l'equivalent de :

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

       sauf que l'indicateur d'erreur du flux est egalement efface. (consultez
       clearerr(3)).

       Les fonctions fgetpos() et fsetpos() sont des alternatives a ftell() et
       fseek() (avec whence a SEEK_SET), en fixant, et en memorisant la valeur
       de l'indicateur de position du fichier dans ou depuis l'objet reference
       par pos. Sur certains systemes non Unix, l'objet fpos_t  peut  etre  un
       objet  complexe,  et  ces  routines  peuvent  etre  les seules methodes
       possibles pour repositionner un flux de texte de maniere portable.

VALEUR RENVOY'EE

       La fonction rewind() ne renvoie pas de  valeur.  Si  elles  reussissent
       totalement,  fgetpos(),  fseek(),  fsetpos()  renvoient  0,  et ftell()
       renvoie la position actuelle. Sinon, elles renvoient -1 et la  variable
       globale errno contient le code d'erreur.

ERREURS

       EBADF  Le flux stream n'est pas un flux positionnable.

       EINVAL L'argument  whence  de fseek() n'etait ni SEEK_SET, ni SEEK_END,
              ni SEEK_CUR.

       Les  fonctions  fgetpos(),  fseek(),  fsetpos(),  et  ftell()   peuvent
       egalement,  en  cas  d'echec, definir errno sur n'importe quelle erreur
       indiquee par les routines fflush(3), fstat(2), lseek(2) et malloc(3).

CONFORMIT'E

       C89, C99.

VOIR AUSSI

       lseek(2), fseeko(3)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue a l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-2006).  Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.