CKTIS / C
rewind — zum Anfang einer Datei zurückkehren
rewind setzt die Position eines Streams auf den Anfang der Datei und löscht dessen Fehlerindikator. Die Funktion gibt keinen Wert zurück und kann daher nicht direkt melden, ob das Positionieren erfolgreich war.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
void rewind(FILE *stream);rewind(stream) aus <stdio.h> setzt einen geöffneten FILE-Stream auf den Anfang seiner Datei. Übergeben Sie einen gültigen Zeiger auf einen geöffneten Stream, nicht NULL und keinen Zeiger, der nach fclose verwendet wird.
Die Funktion wirkt wie (void)fseek(stream, 0L, SEEK_SET), löscht aber zusätzlich den Fehlerindikator. Bei erfolgreichem Positionieren wird auch der Dateiendeindikator gelöscht und die Wirkung von ungetc aufgehoben. Der Dateiinhalt wird nicht gelöscht.
Die Funktion gibt void zurück. Wenn Fehler beim Positionieren erkannt werden müssen, verwenden Sie fseek und prüfen Sie dessen Rückgabewert. Ein Aufruf von ferror allein nach rewind bestätigt keinen Erfolg. Gehen Sie nicht davon aus, dass jeder Stream Positionieren unterstützt.
Beispiele
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *stream = tmpfile();
if (stream == NULL) {
return EXIT_FAILURE;
}
if (fputs("ABC", stream) == EOF || fflush(stream) == EOF) {
fclose(stream);
return EXIT_FAILURE;
}
rewind(stream);
int first = fgetc(stream);
if (first != 'A') {
fclose(stream);
return EXIT_FAILURE;
}
if (fclose(stream) == EOF) {
return EXIT_FAILURE;
}
if (printf("first: %c\n", first) < 0) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Ergebnis
first: A
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.