Partager via


rewind

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

void rewind(
   FILE *stream 
);

Paramètres

  • stream
    Pointeur vers la structure de FICHIER .

Notes

La fonction de rebobinage repositionne le pointeur de fichier associé à stream au début du fichier.un appel à rebobinage est semblable à

fseek (void) ( streamServeur IIS local 0L, SEEK_SET ) ;

Toutefois, contrairement à fseek, rebobinage désactive les indicateurs d'erreurs pour le flux de données ainsi que l'indicateur de fin de fichier.En outre, contrairement à fseek, rebobinage ne retourne pas de valeur pour indiquer si le pointeur a été correctement déplacé.

Pour désactiver la mémoire tampon de clavier, utilisez rebobinage avec le flux de données stdin, qui est associé au clavier par défaut.

Si le flux est un pointeur d' NULL , le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, retourne et l' errno de cette fonction a la valeur EINVAL.

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

Configuration requise

routine

en-tête requis

rebobinage

<stdio.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

bibliothèques

toutes les versions de 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 l' exemples d'appel de code non managé.

Voir aussi

Référence

E/S de flux