KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

rewind — terugkeren naar het begin van een bestand

rewind positioneert een stream aan het begin van het bestand en wist de foutindicator. De functie geeft geen waarde terug en kan dus niet rechtstreeks melden of het verplaatsen is gelukt.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdio.h>
void rewind(FILE *stream);

rewind(stream) uit <stdio.h> positioneert een geopende FILE-stream aan het begin van het bestand. Geef een geldige pointer naar een geopende stream door, niet NULL en geen pointer die na fclose wordt gebruikt.

De functie werkt als (void)fseek(stream, 0L, SEEK_SET), maar wist ook de foutindicator. Als het positioneren lukt, wordt ook de indicator voor het einde van het bestand gewist en worden de effecten van ungetc ongedaan gemaakt. De inhoud van het bestand wordt niet gewist.

De functie retourneert void. Gebruik fseek en controleer het resultaat als mislukte positioneeracties moeten worden vastgesteld. Alleen ferror controleren na rewind bevestigt geen succes. Ga er niet van uit dat elke stream positioneren ondersteunt.

Voorbeelden

#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;
}

Resultaat

first: A

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen