Partager via


fsetpos

Définit l’indicateur de position de flux.

Syntaxe

int fsetpos(
   FILE *stream,
   const fpos_t *pos
);

Paramètres

stream
Pointeur vers la structure FILE .

pos
Stockage de l’indicateur de position.

Valeur retournée

En cas de réussite, fsetpos retourne 0. En cas d’échec, la fonction retourne une valeur différente de zéro et définit errno l’une des constantes manifeste suivantes (définie dans ERRNO. H : EBADF, ce qui signifie que le fichier n’est pas accessible ou l’objet qui stream pointe vers n’est pas une structure de fichiers valide ; ou EINVAL, ce qui signifie qu’une valeur non valide pour stream ou pos a été passée. Si un paramètre non valide est passé, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres.

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La fsetpos fonction définit l’indicateur de position de fichier pour stream la valeur de pos, obtenue dans un appel antérieur à fgetpos contre stream. La fonction efface l’indicateur de fin de fichier et annule les effets de ungetc stream. Après un appel à fsetpos, l’opération stream suivante peut être en entrée ou en sortie.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Fonction En-tête requis
fsetpos <stdio.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple pour fgetpos.

Voir aussi

E/S de flux
fgetpos