Freigeben über


Rückspulen

Positioniert den Dateizeiger am Anfang der Datei an.

void rewind(
   FILE *stream 
);

Parameter

  • stream
    Zeiger auf DATEI Struktur.

Hinweise

Die Zurückspulen-Funktion ordnet der Dateizeiger an, der mit stream auf den Anfang der Datei zugeordnet ist.Ein Aufruf von Zurückspulen vergleichbar ist mit

(fseek (ungültig) streamund 0L. SEEK_SET);

fseek, jedoch nicht gelöscht Zurückspulen die Fehlerindikatoren für den Stream als auch der Dateiende-Indikator.Außerdem gibt fseekanders Zurückspulen keinen Wert zurück, um anzugeben, ob der Zeiger erfolgreich verschoben wurde.

Der Tastaturpuffer löschen, verwenden Sie Zurückspulen mit dem Stream, der stdinmit der Tastatur standardmäßig zugeordnet ist.

Wenn ein Stream NULL Zeiger ist, wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, kehrt diese Funktion zurück und errno wird auf EINVALfestgelegt.

Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Anforderungen

Routine

Erforderlicher Header

Rückspulen

<stdio.h>

Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.

Bibliotheken

Alle Versionen Cs.

Beispiel

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

Output

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

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufrufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Plattformaufruf-Beispiele.

Siehe auch

Referenz

Stream E/A