rewindrewind

Repositionne le pointeur de fichier au début d’un fichier.Repositions the file pointer to the beginning of a file.

SyntaxeSyntax

void rewind(
   FILE *stream
);

ParamètresParameters

streamstream
Pointeur désignant la structure FILE.Pointer to FILE structure.

NotesRemarks

La fonction rembobiner repositionne le pointeur de fichier associé au flux au début du fichier.The rewind function repositions the file pointer associated with stream to the beginning of the file. Un appel à rewind produit les mêmes effets queA call to rewind is similar to

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

Toutefois, contrairement à fseek, le rembobinage efface les indicateurs d’erreur pour le flux, ainsi que l’indicateur de fin de fichier.However, unlike fseek, rewind clears the error indicators for the stream as well as the end-of-file indicator. En outre, contrairement à fseek, Rewind ne retourne pas de valeur pour indiquer si le pointeur a été déplacé avec succès.Also, unlike fseek, rewind does not return a value to indicate whether the pointer was successfully moved.

Pour effacer la mémoire tampon du clavier, utilisez rembobiner avec le flux stdin, qui est associé au clavier par défaut.To clear the keyboard buffer, use rewind with the stream stdin, which is associated with the keyboard by default.

Si Stream est un pointeur null , le gestionnaire de paramètres non valides est appelé, comme décrit dans validation de paramètre.If stream is a NULL pointer, the invalid parameter handler is invoked, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, cette fonction retourne et errno a la valeur EINVAL.If execution is allowed to continue, this function returns and errno is set to EINVAL.

Pour plus d’informations sur ces codes d’erreur et les autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

Configuration requiseRequirements

RoutineRoutine En-tête requisRequired header
rewindrewind <stdio.h><stdio.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.For additional compatibility information, see Compatibility.

BibliothèquesLibraries

Toutes les versions des bibliothèques Runtime C.All versions of the C run-time libraries.

ExempleExample

// crt_rewind.c
/* This program first opens a file named
* crt_rewind.out for input and output and writes two
* integers to the file. Next, it uses rewind to
* reposition the file pointer to the beginning of
* the file and reads the data back in.
*/
#include <stdio.h>

int main( void )
{
   FILE *stream;
   int data1, data2;

   data1 = 1;
   data2 = -37;

   fopen_s( &stream, "crt_rewind.out", "w+" );
   if( stream != NULL )
   {
      fprintf( stream, "%d %d", data1, data2 );
      printf( "The values written are: %d and %d\n", data1, data2 );
      rewind( stream );
      fscanf_s( stream, "%d %d", &data1, &data2 );
      printf( "The values read are: %d and %d\n", data1, data2 );
      fclose( stream );
   }
}

SortieOutput

The values written are: 1 and -37
The values read are: 1 and -37

Voir aussiSee also

E/S de fluxStream I/O