Partager via


rewind

REPLACE le pointeur de fichier au début d'un fichier.

void rewind( 
   FILE *stream  
);

Paramètres

  • stream
    Pointeur vers la structure FICHIER.

Notes

La fonction rewind REPLACE le pointeur de fichier associé à stream au début du fichier. Un appel à rewind est semblable à

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

Toutefois, contrairement à fseek, rewind désactive les indicateurs d'erreur du flux de données ainsi que l'indicateur de fin de fichier. En outre, contrairement à fseek, rewind ne renvoie pas de valeur pour indiquer si le pointeur a été déplacement.

Pour désactiver la mémoire tampon de clavier, utilisez rewind avec le flux, stdinassocié à l'aide de le clavier par défaut.

Si NULL est un pointeur , le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction renvoie un résultat et errno est défini sur EINVAL.

Pour plus d'informations sur ces codes d'erreur et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Configuration requise

Routine

En-tête requis

rewind

<stdio.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

// 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 );
   }
}

Sortie

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

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Voir aussi

Référence

E/S de flux