rewind
Ordnet der Dateizeiger am Beginn einer Datei neu.
void rewind(
FILE *stream
);
Parameter
- stream
Zeiger auf die FILE-Struktur.
Hinweise
Die rewind-Funktion ordnet der Dateizeiger neu mit stream am Anfang der Datei zugeordnet ist. Ein Aufruf rewind entspricht ähnelt
(void) fseek( stream**,** 0L, SEEK_SET );
jedoch, außer fseek, werden rewind die Fehlerindikatoren für den Stream und der Dateiende-Indikator. Auch als fseek, gibt rewind keinen Wert zurück, um anzugeben, ob der Zeiger erfolgreich verschoben wurde.
Die Tastaturpuffer löschen, verwenden Sie rewind mit dem Stream stdin, der mit der Tastatur standardmäßig zugeordnet ist.
Wenn ein Stream NULL Zeiger ist, ist der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die Ausführung zulässig ist, um fortzufahren wird, gibt dieser Funktion und errno auf EINVAL festgelegt.
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> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Alle Versionen C-Laufzeitbibliotheken.
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 );
}
}
Ausgabe
The values written are: 1 and -37
The values read are: 1 and -37
.NET Framework-Entsprechung
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.