WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

ungetc — ein Zeichen in einen Stream zurückstellen

ungetc stellt ein Zeichen zur erneuten Eingabe in einen Stream zurück, ohne die Datei zu ändern. Portabler Code kann sich auf Platz für ein Zeichen verlassen.

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

Syntax

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

ungetc aus <stdio.h> stellt c, nach der Umwandlung in unsigned char, in den Eingabestream stream zurück. Beim nächsten Lesevorgang wird dieses Zeichen abgerufen; es muss nicht mit einem zuvor gelesenen Zeichen übereinstimmen. Die Datei bleibt unverändert.

Die Funktion gibt den zurückgestellten Wert oder bei einem Fehler EOF zurück. Wird EOF übergeben, schlägt der Aufruf fehl, ohne den Stream zu verändern. Speichere Ergebnisse von fgetc in int, nicht in char.

Ein Zeichen ist garantiert; weitere Rückstellungen können fehlschlagen. Die Zeichen werden in umgekehrter Reihenfolge zurückgegeben. Ein erfolgreiches ungetc löscht die End-of-File-Anzeige. Ein erfolgreiches fseek, fsetpos oder rewind verwirft zurückgestellte Zeichen. Dieser Mechanismus dient dem Vorauslesen der Eingabe, nicht dem allgemeinen Zurücksetzen von Lesevorgängen.

Beispiele

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

Ergebnis

X B

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.

Quellen