KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

ungetc — een teken terugzetten in een stream

ungetc zet een teken terug in een stream zodat het opnieuw kan worden gelezen, zonder het bestand te wijzigen. Draagbare code kan rekenen op ruimte voor één teken.

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

Syntax

#include <stdio.h>
int ungetc(int c, FILE *stream);

ungetc uit <stdio.h> zet c, geconverteerd naar unsigned char, terug in de invoerstream stream. Bij de volgende leesbewerking wordt dat teken opgehaald; het hoeft niet overeen te komen met een eerder gelezen teken. Het bestand blijft ongewijzigd.

De functie retourneert de teruggezette waarde of EOF bij een fout. Het doorgeven van EOF leidt tot een fout zonder de stream te wijzigen. Sla resultaten van fgetc op in een int, niet in een char.

Eén teken is gegarandeerd; verdere terugzetbewerkingen kunnen mislukken. Tekens worden in omgekeerde volgorde opgehaald. Een geslaagde aanroep van ungetc wist de indicator voor het einde van het bestand. Een geslaagde aanroep van fseek, fsetpos of rewind verwijdert teruggezette tekens. Dit mechanisme is bedoeld om invoer vooruit te bekijken, niet om leesbewerkingen in het algemeen ongedaan te maken.

Voorbeelden

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE *stream = tmpfile();
    if (stream == NULL)
        return EXIT_FAILURE;

    if (fputs("AB", stream) == EOF || fseek(stream, 0L, SEEK_SET) != 0) {
        fclose(stream);
        return EXIT_FAILURE;
    }

    if (fgetc(stream) != 'A' || ungetc('X', stream) == EOF) {
        fclose(stream);
        return EXIT_FAILURE;
    }

    int first = fgetc(stream);
    int second = fgetc(stream);
    int close_result = fclose(stream);
    if (first != 'X' || second != 'B' || close_result == EOF)
        return EXIT_FAILURE;

    if (printf("%c %c\n", first, second) < 0)
        return EXIT_FAILURE;
    return EXIT_SUCCESS;
}

Resultaat

X B

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