Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] fseek, fgetpos, fsetpos, ftell, rewind - Accéder à la position courante d'un flux. [size=18] [b]Résumé[/b] [/size] [b]#include <stdio.h>[/b] [b][i]int fseek (FILE * stream , long offset , int whence );[/i][/b] [b][/b] [b][i]long ftell (FILE * stream );[/i][/b] [b][/b] [b][i]void rewind (FILE * stream );[/i][/b] [b][/b] [b][i]int fgetpos (FILE * stream , fpos_t * pos );[/i][/b] [b][/b] [b][i]int fsetpos (FILE * stream , fpos_t * pos );[/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]fseek[/b] fixe l'indicateur de position du flux pointé par [b]stream .[/b] La nouvelle position, mesurée en octets, est obtenue en additionnant [i]offset[/i] octets au point de départ indique par [b]whence .[/b] Si [i]whence[/i] vaut [b]SEEK_SET ,[/b] [b]SEEK_CUR ,[/b] ou [b]SEEK_END ,[/b] le point de départ correspond respectivement au début du fichier, à la position actuelle, ou à la fin du fichier. Un appel réussi à [b]fseek[/b] efface l'indicateur de fin de fichier pour le flux, et annule les effets de toute fonction [b]ungetc (3)[/b] précédente sur le même flux. La fonction [b]ftell[/b] lit la valeur de l'indicateur de position pour le flux pointé par [b]stream .[/b] La fonction [b]rewind[/b] ramène l'indicateur de position du flux pointé par [i]stream[/i] au début du fichier. C'est l'équivalent de : [table][row][col]    [/col][col] (void)fseek(stream, 0L, SEEK_SET)[/col][/row][/table] sauf que l'indicateur d'erreur du flux est également effacé. (voir [b]clearerr (3)).[/b] Les fonctions [b]fgetpos[/b] et [b]fsetpos[/b] sont des alternatives à [b]ftell[/b] et [b]fseek[/b] (avec [i]whence[/i] valant [b]SEEK_SET ),[/b] en fixant, ou en mémorisant la valeur de l'indicateur de position du fichier dans l'objet référencé par [b]pos .[/b] Sur certains systèmes non-UNIX, l'objet [b]fpos_t[/b] peut être un objet complexe, et ces routines peuvent être les seules méthodes possibles pour repositionner un flux de texte de manière portable. [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]rewind[/b] ne renvoie pas de valeur. Si elles réussissent totalement, [b]fgetpos ,[/b] [b]fseek ,[/b] [b]fsetpos[/b] renvoient 0, et [b]ftell[/b] renvoie la position actuelle. Sinon, elles renvoient -1 et la variable globale errno contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [table][row][col]    [/col][col]Le flux [i]stream[/i] n'est pas positionnable.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]L'argument [i]whence[/i] dans l'appel [b]fseek[/b] n'était ni [b]SEEK_SET ,[/b] ni [b]SEEK_END ,[/b] ni [b]SEEK_CUR .[/b][/col][/row][/table] Les fonctions [b]fgetpos ,[/b] [b]fseek ,[/b] [b]fsetpos ,[/b] et [b]ftell[/b] peuvent également, en échec, positionner [i]errno[/i] sur n'importe quelle erreur indiquée par les routines [b]fflush (3),[/b] [b]fstat (2),[/b] [b]lseek (2),[/b] et [b]malloc (3).[/b] [size=18] [b]Conformité[/b] [/size] Les fonctions [b]fgetpos ,[/b] [b]fsetpos ,[/b] [b]fseek ,[/b] [b]ftell ,[/b] et [b]rewind[/b] sont conformes a ANSI X3.159-1989 (``ANSI C''). [size=18] [b]Voir aussi[/b] [/size] [b]lseek (2),[/b] [b]fseeko (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier